Comandos e flags - Devin Docs

Uso

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 <MODEL>`		Define o modelo de IA para esta sessão
`--permission-mode <MODE>`		Modo de permissão (`normal`, `dangerous`, `bypass`)
`--continue`	`-c`	Retoma a sessão mais recente no diretório atual
`--resume <SESSION_ID>`	`-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 <FILE>`		Carrega o prompt inicial de um arquivo
`--config <PATH>`		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:

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 <name>`	Adiciona um novo servidor MCP
`devin mcp list`	Lista todos os servidores MCP configurados
`devin mcp get <name>`	Mostra detalhes de um servidor MCP específico
`devin mcp remove <name>`	Remove um servidor MCP configurado
`devin mcp login <name>`	Faz autenticação em um servidor MCP via OAuth
`devin mcp logout <name>`	Remove as credenciais OAuth armazenadas de um servidor MCP
`devin mcp enable <name>`	Ativa um servidor MCP desativado
`devin mcp disable <name>`	Desativa um servidor MCP sem removê-lo

Opções para devin mcp add:

-t, --transport <stdio|http> — Tipo de transporte (opcional; inferido pela URL → http, argumentos finais → stdio)
-s, --scope <local|project|user> — Escopo de configuração (padrão: local)
--url <URL> — URL para transporte HTTP (também pode ser passada como argumento posicional após o nome)
--command <CMD> — Comando para transporte stdio (opcional quando argumentos finais são fornecidos)
-e, --env <KEY=VALUE> — Variáveis de ambiente (repetível)
-H, --header <HEADER: VALUE> — Cabeçalhos HTTP (repetível)
--scopes <SCOPE,SCOPE> — Escopos OAuth a serem solicitados (separados por vírgula)
--oauth-resource <RESOURCE> — Faz override do parâmetro resource da RFC 8707 enviado em requisições OAuth (padrão: a URL do servidor MCP; passe uma string vazia para omiti-lo em provedores que o rejeitam)
<URL> — Argumento posicional de URL para HTTP (alternativa a --url)
-- <COMMAND> [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). Você também pode definir "transport": "sse" explicitamente. Consulte Configuração do MCP → Solução de problemas.

Exemplos:

# 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 <local|project|user> — Escopo de configuração (padrão: local)

Opções para devin mcp login:

--scopes <SCOPE,SCOPE> — Escopos OAuth a serem solicitados (separados por vírgula)
--oauth-resource <RESOURCE> — Override do parâmetro resource da RFC 8707 enviado em requisições OAuth (padrão: a URL do servidor MCP; passe uma string vazia para omiti-lo em provedores que o rejeitam)

Opções para devin mcp enable:

-s, --scope <local|project|user> — Escopo de configuração (padrão: local)

Opções para devin mcp disable:

-s, --scope <local|project|user> — Escopo de configuração (padrão: local)

Consulte Configuração do MCP 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 <name>`	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 <cursor\|windsurf> — Filtra por provedor de regras

Consulte Regras 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 <name>`	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 <user\|model> — Filtre por tipo de acionamento

Consulte Skills 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.

devin version

Isso equivale a devin --version.

devin acp

Execute o Devin como um servidor de Agent Client Protocol (ACP) 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.

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.

devin update

Use --force para reinstalar, mesmo se já estiver na versão mais recente:

devin update --force

devin shell

[Prévia do recurso] Comandos de integração do shell. Consulte Integração do shell 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 <shell>`	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 e execute o Devin dentro da sua distribuição WSL.

devin sandbox setup

devin setup

Assistente interativo para configurar a autenticação e o MCP.

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 <question>`	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 <step>`	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 <new title>`	Renomeia a sessão atual
`/rm-session <session-id>`	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 <path>`	Adiciona um diretório de workspace adicional
`/undo-add-dir <path>`	Remove um diretório de workspace

Automação

Comando	Descrição
`/loop <prompt>`	Executa um prompt e, em seguida, faz auto-review do diff em loop
`/btw <prompt>`	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 <session-id>`	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.

Normal (padrão)
Plan
Bypass

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

Alterne entre os modos com /mode ou mude diretamente com /normal, /accept-edits, /plan ou /bypass. Use /ask <question> 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)

​Uso

​Flags globais

​Subcomandos

​devin auth

​devin mcp

​devin rules

​devin skills

​devin list

​devin version

​devin acp

​devin update

​devin shell

​devin sandbox

​devin sandbox setup

​devin setup

​devin uninstall

​Comandos de barra

​Modo & Modelo

​Gerenciamento de sessões

​Workspace

​Automação

​Extensibilidade

​Utilitários

​Sessões do cloud Devin (apenas para insiders)

​Modos

​Perfis

Uso

Flags globais

Subcomandos

devin auth

devin mcp

devin rules

devin skills

devin list

devin version

devin acp

devin update

devin shell

devin sandbox

devin sandbox setup

devin setup

devin uninstall

Comandos de barra

Modo & Modelo

Gerenciamento de sessões

Workspace

Automação

Extensibilidade

Utilitários

Sessões do cloud Devin (apenas para insiders)

Modos

Perfis