Comandos essenciais - Devin Docs

Iniciando a CLI do Devin

Por padrão, as sessões ocorrem em um REPL, uma interface gráfica de terminal em que você pode conversar com o Devin e acompanhar suas ações.

devin                            # Inicia o REPL interativo (sem prompt)
devin -- your prompt here        # Inicia o REPL com prompt inicial
devin -p "prompt"                # Turno único, sem REPL: imprime a resposta no stdout e encerra
devin -p -- prompt words here    # Mesmo efeito, usando o separador -- (também funciona)

Use -- antes do prompt para que ele seja interpretado como um prompt, e não como um subcomando.

O modo de interação única (-p) é ótimo para scripts e automações.

Digite @ no campo do prompt para abrir o preenchimento automático de arquivos/diretórios locais. Ao selecionar um deles, ele é adicionado como contexto à sua mensagem.

Você pode colar imagens da área de transferência com Ctrl+V. As imagens anexadas aparecem na área de entrada e podem ser gerenciadas com Esquerda/Direita para navegar e Backspace para remover.

Executando comandos no shell

Devin pode executar comandos no shell enquanto trabalha. Se um comando ainda estiver em execução após o período de espera padrão, Devin o coloca em segundo plano e mostra quanto tempo aguardou, junto com o ID do shell em segundo plano. Devin pode então continuar trabalhando e verificar a saída do comando depois.

Modos

O Devin CLI tem 4 modos de permissão integrados: Normal, Accept Edits, Bypass e Autonomous, além de 3 modos do agente: Normal, Plan e Ask. Para Plan e Ask, use /plan e /ask.

Normal

Aprova automaticamente ferramentas somente leitura no diretório atual e solicita permissão para operações de escrita/execução.

/normal
# ou
/mode normal

Este é o modo padrão.

Accept Edits

Aprova automaticamente edições de arquivos no workspace, mas continua pedindo confirmação para comandos de shell e outras ações. Esperamos que a maior parte do tempo seja passada aqui.

/accept-edits
# ou
/mode accept-edits

Bypass

Aprova automaticamente todas as chamadas de ferramentas, incluindo escritas e comandos de shell.

/bypass
# ou
/mode bypass

Você também pode iniciar no modo bypass:

devin --permission-mode bypass

Aliases: /yolo, /dangerous

O modo Bypass nunca faz override de permissões em nível de organização configuradas pelo seu admin em Configurações da equipe. Regras de bloqueio e solicitação impostas pelo admin sempre têm prioridade.

Autonomous

É aproximadamente equivalente ao Accept Edits no workspace atual, com a capacidade adicional de executar qualquer comando de shell dentro de um sandbox em nível de sistema operacional (para limitar o que esses comandos podem realmente acessar).

devin --sandbox --permission-mode autonomous

Autonomous é o único modo de permissão disponível ao executar com --sandbox e é selecionado automaticamente — Normal, Accept Edits e Bypass ficam ocultos em sessões em sandbox.No modo Autonomous…

Você dá permissão para capacidades em vez de comandos.
- Os comandos respeitam os escopos Write e Read por meio de um sandbox do sistema de arquivos.
- Os comandos pedem sua autorização quando tentam se conectar a recursos de rede.
Operações somente leitura no diretório atual são aprovadas automaticamente.

Autonomous depende do sandbox para segurança. Sem --sandbox, o modo não fica disponível — use Bypass se quiser execução não supervisionada sem isolamento em nível de sistema operacional. Veja Bypass vs Autonomous abaixo para uma comparação direta.

Bypass vs Autonomous

Bypass e Autonomous reduzem as solicitações de aprovação, mas usam mecanismos de segurança diferentes:

	Bypass	Autonomous
Requer `--sandbox`	Não	Sim (disponível apenas em sessões em sandbox)
Comandos de shell	Aprovados automaticamente, sem restrições	Aprovados automaticamente, isolados pelo sandbox
Gravações de arquivos via ferramentas `edit`/`write`	Aprovadas automaticamente em qualquer lugar	Ainda solicitam aprovação (conceder um escopo expande o sandbox)
Acesso à rede	Sem restrições	Filtrado pelas listas de permissão/bloqueio de domínios do sandbox
Respeita as Configurações da equipe do admin	Sim	Sim

Escolha Bypass quando você confia no agente para operar em toda a sua máquina. Escolha --sandbox (que seleciona Autonomous) quando quiser execução não supervisionada com limites impostos pelo sistema operacional sobre quais arquivos e domínios o agente pode acessar. Se você gosta da praticidade do bypass, mas quer que o agente tenha seu próprio computador, experimente o cloud Devin!

Histórico da sessão

Seu histórico de conversa é salvo para que você possa retomar a sessão depois.

devin -c              # Continuar a sessão mais recente no diretório atual
devin --continue

devin -r              # Escolher entre sessões recentes
devin --resume
devin -r brisk-otter  # Retomar uma sessão específica pelo ID

Comandos de barra

Você pode usar esses comandos durante uma sessão ativa.

Comando	Descrição
`/help`	Veja todos os comandos disponíveis
`/exit` ou `/quit`	Saia do aplicativo
`/clear` ou `/new`	Limpe o histórico da conversa (comece do zero)

Você também pode digitar exit ou quit como texto simples (sem o prefixo /) para sair.

Alternância de modo

Comando	Descrição
`/mode`	Mostra o modo atual
`/mode <name>`	Alterna o modo (`normal`, `accept-edits`, `plan`, `bypass`; `autonomous` em sessões de sandbox)
`/normal`	Alterna para o modo Normal (padrão)
`/plan`	Alterna para o modo Plan
`/ask <question>`	Faz uma pergunta sem alterar o código (oneshot)
`/bypass`	Alterna para o modo Bypass (aliases: `/yolo`, `/dangerous`)

Troca de modelo

Comando	Descrição
`/model`	Mostrar o seletor de modelo

Gerenciamento de sessões

Comando	Descrição
`/resume`	Abrir o seletor interativo de sessões
`/resume <id>`	Retomar a sessão pelo ID
`/ls`	Listar as sessões recentes no diretório atual (alias: `/list-sessions`)
`/ls --all`	Listar todas as sessões em todos os diretórios
`/continue`	Retomar a sessão mais recente
`/continue <id>`	Retomar a sessão pelo ID
`/rm-session <id>`	Excluir permanentemente uma sessão pelo ID

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 depois faz a revisão automática do diff em loop (requer um estado limpo do git para começar)

Extensibilidade

Comando	Descrição
`/hooks`	Lista todos os hooks carregados com seus IDs, tipos de evento e caminhos de origem

Conta e sistema

Comando	Descrição
`/login`	Faça login no Devin
`/logout`	Limpe as credenciais armazenadas e saia
`/update`	Verifique e instale atualizações
`/upgrade`	Faça upgrade do seu plano de assinatura
`/bug`	Relate um bug aos desenvolvedores da CLI do Devin
`/compact`	Force a compactação da conversa

Se você instalou o Devin para Terminal via Homebrew, /update orientará você a usar brew upgrade devin em vez de executar uma autoatualização.

Atalhos de teclado

Aqui estão os atalhos de teclado mais importantes. Consulte Atalhos de teclado para ver outros atalhos.

Atalho	Descrição
`Shift+Tab`	Alterna entre os modos (Normal, Accept Edits, Plan, Bypass, Autonomous)
`Ctrl+C`	Limpa o texto de entrada ou cancela o agente em execução
`Esc`	Cancela o agente em execução
`Shift+Enter`	Insere uma nova linha (entrada em várias linhas)
`Ctrl+V` ou `Shift+Insert`	Cola da área de transferência
`Ctrl+G`	Abre o editor externo
`Ctrl+O`	Abre o visualizador de rastreamento de raciocínio em tela cheia
`@`	Mencione arquivos para adicioná-los como contexto

​Iniciando a CLI do Devin

​Executando comandos no shell

​Modos

​Bypass vs Autonomous

​Histórico da sessão

​Comandos de barra

​Navegação e controle

​Alternância de modo

​Troca de modelo

​Gerenciamento de sessões

​Workspace

​Automação

​Extensibilidade

​Conta e sistema

​Atalhos de teclado

Iniciando a CLI do Devin

Executando comandos no shell

Modos

Bypass vs Autonomous

Histórico da sessão

Comandos de barra

Navegação e controle

Alternância de modo

Troca de modelo

Gerenciamento de sessões

Workspace

Automação

Extensibilidade

Conta e sistema

Atalhos de teclado