> ## Documentation Index > Fetch the complete documentation index at: https://docs.devin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Comandos e flags > Referência completa de argumentos, subcomandos e comandos de barra interativos
## Uso
```bash theme={null} devin [OPTIONS] [prompt] ``` Forneça um prompt opcional para iniciar uma sessão com uma mensagem inicial ou inicie de forma interativa, sem argumentos. Você também pode consultar essas informações no terminal com `man devin`. ***
## Flags globais
| Flag | Short | Descrição | | --------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------- | | `--model ` | | Define o modelo de IA para esta sessão | | `--permission-mode ` | | Modo de permissão (`normal`, `dangerous`, `bypass`) | | `--continue` | `-c` | Retoma a sessão mais recente no diretório atual | | `--resume ` | `-r` | Retoma uma sessão específica pelo ID | | `--print [PROMPT]` | `-p` | Imprime a resposta e encerra (modo não interativo). Opcionalmente, aceita um prompt inline. | | `--prompt-file ` | | Carrega o prompt inicial de um arquivo | | `--config ` | | Caminho do arquivo de configuração | | `--export [PATH]` | | Exporta a conversa para um arquivo após cada interação (formato ATIF). Usa um caminho padrão se nenhum for fornecido. | | `--respect-workspace-trust` | | Indica se as configurações de confiança do workspace devem ser respeitadas | **Exemplos:** ```bash theme={null} devin -- add a login page devin --model opus -- refactor the auth module devin -c # Retomar última sessão devin -r abc12345 # Retomar sessão específica devin -p "list all TODO comments" # Imprimir resposta e sair devin -p -- list all TODO comments # Mesmo efeito, usando o separador -- (ainda funciona) devin --export -- fix the tests # Exportar conversa para o caminho padrão devin --export out.json -- fix tests # Exportar para um arquivo específico ``` ***
## Subcomandos
### devin auth
Comandos relacionados à autenticação. | Comando | Descrição | | ------------------- | ----------------------------------------- | | `devin auth login` | Fazer login na sua conta | | `devin auth logout` | Sair e remover as credenciais armazenadas | | `devin auth status` | Verificar o status da autenticação | **Opções para `devin auth login`:** * `--force-manual-token-flow` — Ignorar a autenticação pelo navegador e colar manualmente um token (útil para sessões remotas ou via SSH)
### devin mcp
Conecte-se e faça login em servidores do Model Context Protocol. | Comando | Descrição | | -------------------------- | ---------------------------------------------------------- | | `devin mcp add ` | Adiciona um novo servidor MCP | | `devin mcp list` | Lista todos os servidores MCP configurados | | `devin mcp get ` | Mostra detalhes de um servidor MCP específico | | `devin mcp remove ` | Remove um servidor MCP configurado | | `devin mcp login ` | Faz autenticação em um servidor MCP via OAuth | | `devin mcp logout ` | Remove as credenciais OAuth armazenadas de um servidor MCP | | `devin mcp enable ` | Ativa um servidor MCP desativado | | `devin mcp disable ` | Desativa um servidor MCP sem removê-lo | **Opções para `devin mcp add`:** * `-t, --transport ` — Tipo de transporte (opcional; inferido pela URL → http, argumentos finais → stdio) * `-s, --scope ` — Escopo de configuração (padrão: `local`) * `--url ` — URL para transporte HTTP (também pode ser passada como argumento posicional após o nome) * `--command ` — Comando para transporte stdio (opcional quando argumentos finais são fornecidos) * `-e, --env ` — Variáveis de ambiente (repetível) * `-H, --header ` — Cabeçalhos HTTP (repetível) * `--scopes ` — Escopos OAuth a serem solicitados (separados por vírgula) * `` — Argumento posicional de URL para HTTP (alternativa a `--url`) * `-- [ARGS...]` — Comando e argumentos para stdio (o primeiro argumento é o comando quando `--command` é omitido) Os servidores HTTP tentam usar Streamable HTTP primeiro e, em caso de erros 4xx, recorrem ao SSE legado (conforme a [especificação do MCP](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)). Você também pode definir `"transport": "sse"` explicitamente. Consulte [Configuração do MCP → Solução de problemas](/pt-BR/cli/extensibility/mcp/configuration#troubleshooting). **Exemplos:** ```bash theme={null} # servidor stdio devin mcp add my-server -- npx @company/mcp-server --port 3000 # servidor HTTP (URL posicional) devin mcp add notion https://mcp.notion.com/mcp devin mcp add --transport http datadog-mcp https://mcp.datadoghq.com/api/unstable/mcp-server/mcp # servidor HTTP (flag --url, também funciona) devin mcp add notion --url https://mcp.notion.com/mcp # Com variáveis de ambiente e escopo devin mcp add -e GITHUB_TOKEN=ghp_xxx github -- npx -y @modelcontextprotocol/server-github devin mcp add -s project sentry https://mcp.sentry.dev/mcp ``` **Opções para `devin mcp remove`:** * `-s, --scope ` — Escopo de configuração (padrão: `local`) **Opções para `devin mcp login`:** * `--scopes ` — Escopos OAuth a serem solicitados (separados por vírgula) **Opções para `devin mcp enable`:** * `-s, --scope ` — Escopo de configuração (padrão: `local`) **Opções para `devin mcp disable`:** * `-s, --scope ` — Escopo de configuração (padrão: `local`) Consulte [Configuração do MCP](/pt-BR/cli/extensibility/mcp/configuration) para mais detalhes.
### devin rules
Gerencia as regras do agente (blobs de contexto sempre ativos). | Comando | Descrição | | ------------------------- | ----------------------------------------- | | `devin rules list` | Lista todas as regras disponíveis | | `devin rules show ` | Exibe os detalhes de uma regra específica | | `devin rules paths` | Exibe os locais dos diretórios de regras | **Opções para `devin rules list`:** * `--provider ` — Filtra por provedor de regras Consulte [Regras](/pt-BR/cli/extensibility/rules) para mais detalhes.
### devin skills
Gerencie as skills do agente (comandos de barra e blobs de contexto acionados pelo agente). | Comando | Descrição | | -------------------------- | ------------------------------------------ | | `devin skills list` | Liste todas as skills disponíveis | | `devin skills show ` | Exiba os detalhes de uma skill específica | | `devin skills paths` | Exiba os caminhos dos diretórios de skills | **Opções para `devin skills list`:** * `--trigger ` — Filtre por tipo de acionamento Consulte [Skills](/pt-BR/cli/extensibility/skills/overview) para mais detalhes.
### devin list
Lista as sessões no diretório atual. Alias: `devin ls` | Comando | Descrição | | -------------------------- | -------------------------------------- | | `devin list` | Seletor interativo de sessões (padrão) | | `devin list --format json` | Exibe as sessões em JSON | | `devin list --format csv` | Exibe as sessões em CSV |
### devin version
Exibe a versão atual e sai. ```bash theme={null} devin version ``` Isso equivale a `devin --version`.
### devin acp
Execute o Devin como um servidor de [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) via stdio. Este subcomando foi projetado para ser invocado como subprocesso por um editor ou IDE compatível com ACP (como Windsurf ou Zed) — ele se comunica por JSON-RPC via stdin/stdout e não deve ser executado de forma interativa. ```bash theme={null} devin acp ``` O servidor ACP obtém as credenciais de `WINDSURF_API_KEY`, se ela estiver definida; caso contrário, usa as credenciais armazenadas por `devin auth login`. Ele também pode aceitar credenciais em tempo de execução por meio da requisição ACP `authenticate`.
### devin update
Verifique se há atualizações e, se desejar, instale-as. ```bash theme={null} devin update ``` Use `--force` para reinstalar, mesmo se já estiver na versão mais recente: ```bash theme={null} devin update --force ```
### devin shell
\[Prévia do recurso] Comandos de integração do shell. Consulte [Integração do shell](/pt-BR/cli/shell-integration) para obter todos os detalhes. | Comando | Descrição | | --------------------------- | ---------------------------------------------------------------------- | | `devin shell setup` | Instalar a integração do shell no arquivo de configuração do seu shell | | `devin shell setup ` | Instalar para um shell específico (`bash`, `zsh` ou `fish`) |
### devin sandbox
\[Prévia de pesquisa] Gerencie o isolamento em sandbox de processos no nível do sistema operacional para a ferramenta exec. Passe a flag global `--sandbox` para executar uma sessão com o sandbox habilitado.
#### devin sandbox setup
Exibe os pré-requisitos do sandbox para a plataforma atual. Requisitos para executar com `--sandbox`: * **Linux**: requer bubblewrap (`bwrap`) e `socat`. Se algum deles estiver ausente, a sessão de sandbox não será iniciada e serão exibidas instruções de instalação — inclusive em uma distribuição WSL recém-instalada. * **macOS**: funciona imediatamente com Seatbelt; nenhum pacote extra é necessário. * **Windows**: o Windows nativo não consegue executar o sandbox. [Instale o WSL 2](https://learn.microsoft.com/windows/wsl/install) e execute o Devin dentro da sua distribuição WSL. ```bash theme={null} devin sandbox setup ```
### devin setup
Assistente interativo para configurar a autenticação e o MCP. ```bash theme={null} devin setup devin setup --force-manual-token-flow # Para sessões remotas/SSH ```
### devin uninstall
Desinstala a CLI do Devin e, opcionalmente, remove todos os dados. | Opção | Descrição | | --------- | ------------------------------------------------------------------------------- | | `--clean` | Remove todos os dados, incluindo configuração, histórico e dados personalizados | | `--force` | Ignora a solicitação de confirmação | ***
## Comandos de barra
Esses comandos estão disponíveis em uma sessão interativa. Digite-os no prompt.
### Modo & Modelo
| Comando | Descrição | | | | | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ---- | --------- | ---------------------------------------------------------------------------------- | | \`/mode \[normal | accept-edits | plan | bypass]\` | Exibe ou alterna o modo atual (`autonomous` está disponível em sessões de sandbox) | | `/normal` | Alterna para o modo Normal (padrão) | | | | | `/accept-edits` | Alterna para o modo Accept Edits (aprova automaticamente edições de arquivos no workspace) | | | | | `/plan` | Alterna para o modo Plan (planejamento somente leitura) | | | | | `/ask ` | Faz uma pergunta sem fazer alterações no código (oneshot) | | | | | `/bypass` | Alterna para o modo Bypass (aprova automaticamente todas as ações) | | | | | `/model [name]` | Exibe ou altera o modelo atual | | | | | `/fast` | Alterna para SWE-1.6 Fast | | | | | `/theme [dark\|light\|terminal-dark\|terminal-light\|no-color]` | Alterna entre temas (escuro, claro, terminal escuro, terminal claro, sem cor) | | | | `/bypass` tem os aliases `/yolo` e `/dangerous`. Os três fazem a mesma coisa.
### Gerenciamento de sessões
| Comando | Descrição | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | `/clear` | Limpa o histórico da conversa e inicia uma nova sessão. Alias: `/new` | | `/continue [session-id]` | Retoma uma sessão anterior | | `/fork [step]` | Cria um fork da sessão atual em uma nova sessão. Opcionalmente, faça o fork a partir de uma etapa específica (consulte `/steps`). | | `/steps` | Lista as etapas da conversa (use com `/fork` e `/revert`) | | `/revert ` | Reverte as alterações nos arquivos a partir de uma etapa específica e retrocede a conversa para antes dessa etapa | | `/resume [session-id]` | Abre o seletor interativo de sessões ou retoma uma sessão específica pelo ID | | `/ls [--all]` | Lista as sessões recentes (apenas no diretório atual por padrão). Alias: `/list-sessions` | | `/rename-session ` | Renomeia a sessão atual | | `/rm-session ` | Exclui permanentemente uma sessão e todos os dados dela | | `/export` | Mostra informações de exportação. Use a flag `--export` da CLI para ativar a exportação da conversa. | | `/exit` | Sai do aplicativo (alias: `/quit`). Você também pode digitar `exit` ou `quit` sem o prefixo `/`. |
### Workspace
| Comando | Descrição | | ---------------------- | ------------------------------------------------------- | | `/workspace` | Lista os diretórios de workspace (alias: `/workspaces`) | | `/add-dir ` | Adiciona um diretório de workspace adicional | | `/undo-add-dir ` | Remove um diretório de workspace |
### Automação
| Comando | Descrição | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `/loop ` | Executa um prompt e, em seguida, faz auto-review do diff em loop | | `/btw ` | Faz uma pergunta rápida à parte. Executa um fluxo paralelo usando o contexto atual da conversa e exibe a resposta em uma caixa, sem adicionar a pergunta à conversa principal. |
### Extensibilidade
| Comando | Descrição | | -------- | ---------------------------------------------------------------------------------- | | `/hooks` | Lista todos os hooks carregados com seus IDs, tipos de evento e caminhos de origem |
### Utilitários
| Comando | Descrição | | -------------------- | --------------------------------------------------------------------------------------------------------------- | | `/help` | Mostrar os comandos de barra disponíveis | | `/shortcuts` | Explorar atalhos de teclado em uma lista interativa, pesquisável e agrupada por categoria | | `/bug [description]` | Relatar um bug aos desenvolvedores do Devin CLI | | `/update [--force]` | Verificar e instalar atualizações. Use `--force` para reinstalar mesmo se já estiver na versão mais recente. | | `/upgrade` | Fazer upgrade do seu plano de assinatura | | `/login` | Fazer login na sua conta | | `/logout` | Limpar as credenciais armazenadas e sair | | `/context` | Mostrar o uso da janela de contexto | | `/usage` | Mostrar o uso estimado de crédito/ACU da sessão, incluindo o uso de aberturas anteriores de uma sessão retomada | | `/compact` | Forçar a compactação da conversa |
### Sessões do cloud Devin (apenas para insiders)
| Comando | Descrição | | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/cloud-sessions [--all]` | Abre um seletor interativo das suas sessões recentes do cloud Devin. Use as setas para navegar, digite para filtrar, pressione Enter para se conectar e Esc para cancelar. Passe `--all` para ver sessões em nível da organização. | | `/cloud-attach ` | Conecta você a uma sessão do cloud Devin com renderização completa da TUI e entrada bidirecional. | ***
## Modos
Os modos controlam o nível de autonomia do agente ao combinar um modo de permissão com um perfil do agente. Autonomia total para tarefas complexas de programação. O agente pode ler, gravar e executar comandos com verificações normais de permissão. * **Modo de permissão:** Normal * **Perfil:** Normal * **Use para:** Refatoração em vários arquivos, implementação de funcionalidades, correções de bugs Apenas planejamento — o agente propõe mudanças sem executá-las. O acesso somente leitura às ferramentas garante que nenhum código seja modificado. * **Modo de permissão:** Normal * **Perfil:** Plan (ferramentas somente leitura) * **Use para:** Design de arquitetura, entendimento de bases de código, planejamento antes da implementação Todas as solicitações de permissão são aprovadas automaticamente. O agente executa livremente sem pedir confirmação. * **Modo de permissão:** Dangerous * **Perfil:** Normal * **Use para:** Tarefas confiáveis em que interrupções só atrapalham Use o modo Bypass apenas em tarefas nas quais você confia totalmente. Todas as chamadas de ferramenta (incluindo comandos destrutivos) são aprovadas automaticamente. Alterne entre os modos com `/mode` ou mude diretamente com `/normal`, `/accept-edits`, `/plan` ou `/bypass`. Use `/ask ` como um comando oneshot para fazer perguntas sem trocar de modo. ***
## Perfis
Os perfis determinam as ferramentas disponíveis e o comportamento do agente. Os perfis são definidos automaticamente quando você muda de modo. | Perfil | Descrição | Acesso às ferramentas | | -------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | | `normal` | Assistente de programação completo (usado pelos modos Normal, Accept Edits e Bypass) | Todas as ferramentas | | `plan` | Fluxo de trabalho de planejamento estruturado (usado pelo modo Plan) | Ferramentas somente leitura (grep, glob, read, todo, ask\_user\_question, exit\_plan\_mode) | | `ask` | Resposta a perguntas (usado pelo comando `/ask`) | Ferramentas somente leitura (grep, glob, read, todo, ask\_user\_question) |