> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos essenciais

> Se você só lembrar de uma coisa...

<div id="starting-devin-cli">
  ## Iniciando a CLI do Devin
</div>

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.

```bash theme={null}
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)
```

<Note>
  Use `--` antes do prompt para que ele seja interpretado como um prompt, e não como um subcomando.
</Note>

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

<Note>
  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.
</Note>

<Tip>
  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.
</Tip>

<div id="running-shell-commands">
  ## Executando comandos no shell
</div>

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.

***

<div id="modes">
  ## Modos
</div>

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`.

<AccordionGroup>
  <Accordion title="Normal" defaultOpen icon="robot">
    Aprova automaticamente ferramentas somente leitura no diretório atual e solicita permissão para operações de escrita/execução.

    ```bash theme={null}
    /normal
    # ou
    /mode normal
    ```

    Este é o modo padrão.
  </Accordion>

  <Accordion title="Accept Edits" icon="check">
    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.

    ```bash theme={null}
    /accept-edits
    # ou
    /mode accept-edits
    ```
  </Accordion>

  <Accordion title="Bypass" icon="bolt">
    <Warning>
      Aprova automaticamente **todas** as chamadas de ferramentas, incluindo escritas e comandos de shell.
    </Warning>

    ```bash theme={null}
    /bypass
    # ou
    /mode bypass
    ```

    Você também pode iniciar no modo bypass:

    ```bash theme={null}
    devin --permission-mode bypass
    ```

    Aliases: `/yolo`, `/dangerous`

    <Note>
      O modo Bypass **nunca** faz override de permissões em nível de organização configuradas pelo seu admin em [Configurações da equipe](/pt-BR/cli/enterprise/team-settings). Regras de bloqueio e solicitação impostas pelo admin **sempre** têm prioridade.
    </Note>
  </Accordion>

  <Accordion title="Autonomous" icon="robot">
    É 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](/pt-BR/cli/reference/configuration/config-file#sandbox) (para limitar o que esses comandos podem realmente acessar).

    ```bash theme={null}
    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.

    <Note>
      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](#bypass-vs-autonomous) abaixo para uma comparação direta.
    </Note>
  </Accordion>
</AccordionGroup>

<div id="bypass-vs-autonomous">
  ### Bypass vs Autonomous
</div>

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](/pt-BR/cli/reference/configuration/config-file#sandbox) do sandbox |
| Respeita as [Configurações da equipe](/pt-BR/cli/enterprise/team-settings) 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!

<div id="session-history">
  ## Histórico da sessão
</div>

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

```bash theme={null}
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
```

***

<div id="slash-commands">
  ## Comandos de barra
</div>

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

<div id="navigation-control">
  ### Navegação e controle
</div>

| 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) |

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

<div id="mode-switching">
  ### Alternância de modo
</div>

| 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`)                                     |

<div id="model-switching">
  ### Troca de modelo
</div>

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

<div id="session-management">
  ### Gerenciamento de sessões
</div>

| 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                              |

<div id="workspace">
  ### Workspace
</div>

| 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                        |

<div id="automation">
  ### Automação
</div>

| 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) |

<div id="extensibility">
  ### Extensibilidade
</div>

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

<div id="account-system">
  ### Conta e sistema
</div>

| 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                   |

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

***

<div id="keyboard-shortcuts">
  ## Atalhos de teclado
</div>

Aqui estão os atalhos de teclado mais importantes. Consulte [Atalhos de teclado](/pt-BR/cli/reference/keyboard-shortcuts) 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                       |
