Skip to main content

Uso

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

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.
Exemplos:

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â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:
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 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
Consulte Regras para mais detalhes.

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
Consulte Skills para mais detalhes.

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
Consulte Plugins para mais detalhes.

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)
A migração é uma cópia única. As configurações que o Devin CLI lê diretamente — Regras, skills e servidores MCP do Cursor, Windsurf, Claude Code, Copilot e outros — não precisam ser migradas; consulte Importação de configuração.

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 por devin 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)
Opções de 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)
Opções de 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
Consulte a Referência de blueprints para conhecer o formato do environment.yaml que esses comandos leem e gravam.

devin version

Exibe a versão atual e sai.
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.
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. 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:
  • /login e /logout ficam 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.
Use --force para reinstalar, mesmo se já estiver na versão mais recente:

devin shell

[Prévia do recurso] Comandos de integração do shell. Consulte Integração do shell para obter todos os detalhes.

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 setup

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

devin doctor

Diagnostique a configuração air-gapped e a conectividade com o endpoint do modelo.
devin doctor está disponível apenas em builds air-gapped da CLI.

devin worker

Executa a CLI como um worker do Outposts. Esse subcomando fica oculto em devin --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 do cloud Devin (apenas para insiders)


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
Alterne entre os modos com /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.

Perfis

Os perfis determinam as ferramentas disponíveis e o comportamento do agente. Os perfis são definidos automaticamente quando você muda de modo.