Uso
man devin.
Flags globais
O modo não interativo
--print não pode exibir o prompt de confiança do workspace e, por isso, falha em diretórios não confiáveis. Passe --respect-workspace-trust false para pular a verificação em scripts e CI.Subcomandos
devin auth
Comandos relacionados à 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.
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âmetroresourceda 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 não relacionados à autenticação, como 404 ou 405, recorrem ao SSE legado (conforme a especificação do MCP). Respostas 401 e respostas 403 por escopo insuficiente que trazem um desafio
WWW-Authenticate são reportadas diretamente para que você possa se autenticar. Você também pode definir "transport": "sse" explicitamente. Consulte Configuração do MCP → Solução de problemas.devin mcp remove:
-s, --scope <local|project|user>— Escopo de configuração (padrão:local)
devin mcp login:
--scopes <SCOPE,SCOPE>— Escopos OAuth a serem solicitados (separados por vírgula)--oauth-resource <RESOURCE>— Override do parâmetroresourceda 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)
devin mcp enable:
-s, --scope <local|project|user>— Escopo de configuração (padrão:local)
devin mcp disable:
-s, --scope <local|project|user>— Escopo de configuração (padrão:local)
devin models
Liste os modelos disponíveis na sua conta.
Consulte Models para mais detalhes.
devin rules
Gerencia as regras do agente (blobs de contexto sempre ativos).
Opções para
devin rules list:
--provider <cursor\|windsurf>— Filtra por provedor de regras
devin skills
Gerencie as skills do agente (comandos de barra e blobs de contexto acionados pelo agente).
Opções para
devin skills list:
--trigger <user\|model>— Filtre por tipo de acionamento
devin plugins
Gerencie plugins — pacotes que incluem skills, regras, hooks, servidores MCP e subagentes.
Uma origem pode ser um
owner/repo do GitHub, uma URL do git ou um caminho local. Acrescente #path/to/plugin quando o plugin estiver em um subdiretório da raiz do repositório.
Opções:
-y, --yes(install) — Ignore o prompt interativo de confiança--force(remove) — Remova mesmo que outro plugin ou uma configuração de governança ainda o exija
devin migrate
Migra configurações de outras ferramentas para os formatos do Devin.
Opções de
devin migrate workflows:
--scope <all\|workspace\|global>— Quais workflows migrar (padrão:all)
devin list
Lista as sessões no diretório atual. Alias:devin ls
devin cloud
Gerencie os recursos do Devin Cloud pelo terminal. Os comandos usam as credenciais armazenadas pordevin auth login — não é necessária nenhuma configuração adicional do ambiente.
devin cloud drs
Gerencie a Configuração Declarativa de Repositórios: blueprints de ambiente, sessões em sandbox para testar a configuração de repositórios e builds de snapshot.
Opções de
devin cloud drs sandbox-create:
--repo <owner/repo>— Repositório ao qual vincular o sandbox (obrigatório)--prompt <PROMPT>— Prompt inicial para a sessão em sandbox--secret <KEY=VALUE>— Secret por sessão (repetível)
devin cloud drs run:
--devin-id <ID>— ID da sessão do Devin (por exemplo,devin-abc123…) (obrigatório)--command <CMD>— Comando de shell a executar (obrigatório)--timeout <SECONDS>— Tempo limite no servidor (padrão:600)
devin cloud drs blueprint-create:
--repo <owner/repo>— Repositório ao qual atribuir o escopo do blueprint; omita para um blueprint de nível da organização--from-file <FILE>— Arquivo YAML com o conteúdo inicial do blueprint
environment.yaml que esses comandos leem e gravam.
devin version
Exibe a versão atual e sai.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.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.
Opções:
Comandos de barra em hosts ACP
O servidor ACP disponibiliza todo o conjunto de comandos de barra pelo protocolo, para que eles apareçam na paleta de comandos do próprio host, com descrições, dicas de argumentos e categorias:
Alguns comandos dependem do host e da sua conta:
/logine/logoutficam ocultos quando o host gerencia a autenticação.- Os comandos de diretório do workspace (
/workspace,/add-dir,/remove-dir) aparecem apenas quando o host solicita que o agente assuma os diretórios raiz do workspace. Hosts que gerenciam seus próprios diretórios raiz nunca os exibem.
devin update
Verifique se há atualizações e, se desejar, instale-as.--force para reinstalar, mesmo se já estiver na versão mais recente:
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) esocat. 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 setup
Assistente interativo para configurar a autenticação e o MCP.devin doctor
Diagnostica a configuração local do Devin. O comando informa quais perfis de subagente personalizado foram carregados, sinaliza qualquer definiçãoAGENT.md cujo frontmatter não pôde ser interpretado (essas definições são ignoradas em tempo de execução) e emite avisos sobre chaves de frontmatter que o Devin ignora. O comando termina com status diferente de zero se alguma verificação falhar.
devin airgap doctor
Diagnostica a configuração air-gapped e a conectividade com os endpoints de modelo. Além da verificação de subagentes personalizados feita pelodevin doctor, este comando verifica a licença, os caminhos de configuração locais e o arquivo de modelos, além de testar cada endpoint de modelo configurado.
devin airgap doctor está disponível apenas nos builds air-gapped da CLI.devin ssh
Acesse por SSH a VM de uma sessão em nuvem. Encapsula ossh do sistema para o gateway SSH do Devin e aprova a conexão com as credenciais da sua conta autenticada, dispensando idas e voltas pelo navegador. Veja SSH.
devin forward
Encaminha portas da VM de uma sessão em nuvem para o localhost, permitindo abrir um servidor de desenvolvimento que esteja rodando na máquina emhttp://localhost:<port>. Fica em execução até você pressionar Ctrl-C.
<port> ou <local>:<port>:
devin worker
Executa a CLI como um worker do Outposts. Esse subcomando fica oculto emdevin --help e é documentado separadamente — consulte a referência do Outposts.
devin uninstall
Desinstala a CLI do Devin e, opcionalmente, remove todos os dados.Comandos de barra
Esses comandos estão disponíveis em uma sessão interativa. Digite-os no prompt.Modo & Modelo
/bypass tem os aliases /yolo e /dangerous. Os três fazem a mesma coisa.Gerenciamento de sessões
Workspace
Automação
Extensibilidade
Utilitários
Estatísticas da sessão
/session-stats (alias /stats) é a visualização completa do consumo de uma sessão, enquanto /usage apresenta um resumo conciso de créditos/ACUs. Ele exibe todas as dimensões de uso informadas pelo servidor — créditos, ACUs, mensagens do agente, continuações de turnos e uso de tokens — usando os próprios rótulos e agrupamentos do servidor, para que novas dimensões apareçam sem atualização da CLI. A linha Model indica o modelo que de fato processou os turnos faturados, que pode ser diferente do modelo selecionado. Os totais persistem após a retomada; portanto, uma sessão retomada informa seu uso acumulado em vez de começar do zero.
Sessões em nuvem
Consulte Cloud CLI para um guia sobre como executar sessões do Devin Cloud pelo terminal.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
- Smart
- Bypass
- Autonomous
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
/mode ou mude diretamente com /normal, /accept-edits, /smart, /plan, /bypass ou /autonomous. Use /ask <question> como um comando oneshot para fazer perguntas sem trocar de modo.

