Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

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.
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
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.
É 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:
BypassAutonomous
Requer --sandboxNãoSim (disponível apenas em sessões em sandbox)
Comandos de shellAprovados automaticamente, sem restriçõesAprovados automaticamente, isolados pelo sandbox
Gravações de arquivos via ferramentas edit/writeAprovadas automaticamente em qualquer lugarAinda solicitam aprovação (conceder um escopo expande o sandbox)
Acesso à redeSem restriçõesFiltrado pelas listas de permissão/bloqueio de domínios do sandbox
Respeita as Configurações da equipe do adminSimSim
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.
ComandoDescrição
/helpVeja todos os comandos disponíveis
/exit ou /quitSaia do aplicativo
/clear ou /newLimpe 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

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

Troca de modelo

ComandoDescrição
/modelMostrar o seletor de modelo

Gerenciamento de sessões

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

Workspace

ComandoDescrição
/workspaceLista 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

ComandoDescriçã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

ComandoDescrição
/hooksLista todos os hooks carregados com seus IDs, tipos de evento e caminhos de origem

Conta e sistema

ComandoDescrição
/loginFaça login no Devin
/logoutLimpe as credenciais armazenadas e saia
/updateVerifique e instale atualizações
/upgradeFaça upgrade do seu plano de assinatura
/bugRelate um bug aos desenvolvedores da CLI do Devin
/compactForce 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.
AtalhoDescrição
Shift+TabAlterna entre os modos (Normal, Accept Edits, Plan, Bypass, Autonomous)
Ctrl+CLimpa o texto de entrada ou cancela o agente em execução
EscCancela o agente em execução
Shift+EnterInsere uma nova linha (entrada em várias linhas)
Ctrl+V ou Shift+InsertCola da área de transferência
Ctrl+GAbre o editor externo
Ctrl+OAbre o visualizador de rastreamento de raciocínio em tela cheia
@Mencione arquivos para adicioná-los como contexto