# Usa il comando dvina

> Scopri cosa fa il comando dvina quando Dvina esegue codice per te, quali comandi include e quali richiedono la tua approvazione.

Quando Dvina esegue codice o comandi per te, dispone di un comando dedicato: `dvina`. Con questo comando, uno script o una sequenza di passaggi può cercare nel tuo Dvina, leggere e aggiungere documenti, memoria e attività e verificare chi ha accesso a un elemento, agendo a tuo nome.

Non devi installare nulla né accedere a un account. Dvina usa il comando quando la tua richiesta lo richiede, ma puoi anche chiederlo esplicitamente, ad esempio: "Usa dvina per elencare le mie attività e scrivere un riepilogo come nota."

## Come funziona

- `dvina` opera nel tuo Dvina, a tuo nome, con le autorizzazioni del tuo ruolo e nei tuoi limiti abituali.
- L'accesso dura solo mentre Dvina lavora alla tua richiesta. Al termine della risposta, il comando non può più accedere al tuo Dvina.
- Legge un file o una cartella solo quando un comando li indica esplicitamente, ad esempio un file da caricare.

## Comandi

I comandi sono organizzati in gruppi: `dvina <group> <command>`, seguito dagli argomenti e dalle opzioni del comando.

| Gruppo     | Comandi                                                                                                                  |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: cerca contemporaneamente nelle tue chat, nei documenti, nella memoria e nel mondo.              |
| `memory`   | `ls`, `show`, `add`, `edit`: elenca, leggi, aggiungi o modifica i tuoi file di memoria.                                  |
| `world`    | `topics`, `topic`, `recall`, `feed`: i tuoi argomenti, ciò che Dvina sa su qualcosa e il tuo Feed.                        |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: i documenti e le cartelle della tua Library. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: elenca, leggi, crea o riscrivi le pagine dei canvas.                                |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: le tue attività in background.                                                |
| `goals`    | `show`, `start`: attività che lavorano per raggiungere un obiettivo.                                                    |
| `schedule` | `ls`, `add`, `cancel`: messaggi e promemoria programmati, singoli o ricorrenti.                                          |
| `agents`   | `ls`, `show`, `create`, `update`: i tuoi agenti.                                                                         |
| `skills`   | `ls`, `show`, `add`, `edit`: le tue skill.                                                                              |
| `projects` | `ls`, `show`: i tuoi progetti.                                                                                         |
| `settings` | `get`, `set`: le tue preferenze, come attivare o disattivare la memoria.                                                 |
| `share`    | `state`, `with-me`, `add`, `rm`: chi ha accesso a un elemento, cosa altri hanno condiviso con te e come concedere o revocare l'accesso. |

`dvina` non può eliminare nulla definitivamente, aprire link pubblici, connettere o disconnettere app, né modificare le impostazioni di amministrazione o fatturazione.

### Guida e output

- `dvina --help` elenca i gruppi, `dvina <group> --help` elenca i comandi di un gruppo e `dvina <group> <command> --help` elenca gli argomenti e le opzioni di un comando.
- L'output è un testo breve. Aggiungi `--json` per ottenere JSON, oppure `--fields` con un elenco separato da virgole, come `--fields id,title`, per mantenere solo alcuni campi.
- Un elenco lungo termina con `next: --cursor <c>`. Esegui di nuovo il comando con quel `--cursor` per ottenere la pagina successiva.
- Per leggere un valore da un file, aggiungi `-file` alla relativa opzione, come in `--content-file notes.md`. `dvina docs upload <file>` carica un file e `dvina skills add <folder>` aggiunge una cartella di skill con il suo SKILL.md.

### Codici di uscita

| Codice | Significato                                                                   |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Operazione completata.                                                        |
| `1`  | Si è verificato un altro errore.                                              |
| `2`  | Il comando non è corretto. Consulta il suo `--help`.                           |
| `3`  | Non trovato.                                                                 |
| `4`  | Operazione rifiutata: le tue autorizzazioni, le regole aziendali o la protezione dei dati non la consentono. |
| `5`  | È necessaria la tua approvazione.                                             |
| `6`  | Hai raggiunto il limite di utilizzo.                                          |

## Approva le modifiche

- I comandi di lettura vengono eseguiti senza chiedere conferma.
- I comandi che aggiungono qualcosa di nuovo, come `docs create`, `memory add` o `tasks start`, vengono eseguiti senza chiedere conferma. Non modificano mai ciò che esiste già.
- I comandi che modificano o rimuovono qualcosa chiedono prima la tua approvazione: spostare, rinominare, spostare nel cestino, sostituire una nota o un file di memoria, riscrivere una pagina di canvas, modificare un agente o una skill, interrompere un'attività, annullare un messaggio programmato e condividere. Dvina mostra nella chat una scheda di approvazione con un proprio riepilogo della modifica e chiede l'approvazione ogni volta. Se la rifiuti, non cambia nulla.

Ciò che `dvina` aggiunge o modifica è soggetto alle regole aziendali per la protezione dei dati e viene registrato nel tuo [registro di controllo](/docs/teams/audit-log), come le altre azioni di Dvina.

## Pagine correlate

- [Usa Dvina da altre app con MCP](/docs/dvina-mcp/overview)
- [Attività](/docs/use-dvina/features/tasks)
- [Panoramica dei connettori](/docs/connectors/overview)