# Use o comando dvina

> Saiba o que o comando dvina faz quando Dvina executa código para você, quais comandos estão disponíveis e quais pedem sua aprovação.

Quando Dvina executa código ou comandos para você, conta com um comando próprio: `dvina`. Com ele, um script ou uma sequência de etapas pode pesquisar no seu Dvina, ler e adicionar documentos, memória e tarefas, além de verificar quem tem acesso a um item, em seu nome.

Você não precisa instalar nada nem iniciar sessão. Dvina usa o comando quando sua solicitação exige, e você também pode pedir, por exemplo: "Use dvina para listar minhas tarefas e escrever um resumo em uma nota."

## Como funciona

- `dvina` atua no seu próprio Dvina, em seu nome, com as permissões da sua função e dentro dos seus limites habituais.
- O acesso dura apenas enquanto Dvina trabalha na sua solicitação. Quando a resposta termina, o comando não pode mais acessar seu Dvina.
- Ele só lê um arquivo ou uma pasta quando um comando especifica esse arquivo ou pasta, como um arquivo para enviar.

## Comandos

Os comandos são organizados em grupos: `dvina <group> <command>`, seguido dos argumentos e das opções do comando.

| Grupo      | Comandos                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: pesquise nas suas conversas, documentos, memória e mundo de uma só vez.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: liste, leia, adicione ou altere seus arquivos de memória.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: seus tópicos, o que Dvina sabe sobre algo e seu Feed.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: documentos e pastas da sua Biblioteca. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: liste, leia, crie ou reescreva páginas do canvas.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: suas tarefas em segundo plano.                                                        |
| `goals`    | `show`, `start`: tarefas que trabalham para alcançar um objetivo.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: mensagens e lembretes agendados, únicos ou recorrentes.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: seus agentes.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: suas habilidades.                                                                                |
| `projects` | `ls`, `show`: seus projetos.                                                                                             |
| `settings` | `get`, `set`: suas preferências, como ativar ou desativar a memória.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: quem tem acesso a um item, o que outras pessoas compartilharam com você e como conceder ou remover acesso.  |

`dvina` não pode excluir nada permanentemente, abrir links públicos, conectar ou desconectar apps nem alterar configurações de administração ou cobrança.

### Ajuda e saída

- `dvina --help` lista os grupos, `dvina <group> --help` lista os comandos de um grupo e `dvina <group> <command> --help` lista os argumentos e as opções de um comando.
- A saída é um texto curto. Adicione `--json` para obter JSON ou `--fields` com uma lista separada por vírgulas, como `--fields id,title`, para manter apenas alguns campos.
- Uma lista longa termina com `next: --cursor <c>`. Execute o comando novamente com esse `--cursor` para obter a próxima página.
- Para ler um valor de um arquivo, adicione `-file` à opção correspondente, como em `--content-file notes.md`. `dvina docs upload <file>` envia um arquivo, e `dvina skills add <folder>` adiciona uma pasta de habilidade com seu SKILL.md.

### Códigos de saída

| Código | Significado                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Concluído.                                                                         |
| `1`  | Algo mais deu errado.                                                    |
| `2`  | O comando está incorreto. Consulte seu `--help`.                                     |
| `3`  | Não encontrado.                                                                    |
| `4`  | Recusado: suas permissões de acesso, as regras da sua empresa ou a proteção de dados não permitem a ação. |
| `5`  | Precisa da sua aprovação.                                                       |
| `6`  | Você atingiu seu limite de uso.                                              |

## Aprove alterações

- Comandos de leitura são executados sem pedir aprovação.
- Comandos que adicionam algo novo, como `docs create`, `memory add` ou `tasks start`, são executados sem pedir aprovação. Eles nunca alteram o que já existe.
- Comandos que alteram ou removem algo pedem sua aprovação primeiro: mover, renomear, mover para a lixeira, substituir uma nota ou um arquivo de memória, reescrever uma página do canvas, alterar um agente ou uma habilidade, parar uma tarefa, cancelar uma mensagem agendada e compartilhar. Dvina mostra um cartão de aprovação na conversa com um resumo da alteração feito pelo próprio Dvina e pede aprovação todas as vezes. Se você rejeitar, nada muda.

Tudo o que `dvina` adiciona ou altera passa pelas regras de proteção de dados da sua empresa e é registrado no seu [log de auditoria](/docs/teams/audit-log), assim como as outras ações de Dvina.

## Veja também

- [Use Dvina em outros apps com MCP](/docs/dvina-mcp/overview)
- [Tarefas](/docs/use-dvina/features/tasks)
- [Visão geral dos conectores](/docs/connectors/overview)