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

# Integração com o shell [Prévia do recurso]

> Integre seu shell ao Devin para acioná-lo instantaneamente e dar ao Devin visibilidade sobre seus comandos recentes.

<Info>
  A integração com o shell é uma **Prévia do recurso**. Ela está disponível no macOS, Linux e WSL com Bash, Zsh e Fish. A integração com o shell ainda não é compatível com o Windows (PowerShell ou CMD). Você ainda pode executar o Devin CLI no Windows — esse recurso só ainda não está disponível por lá. O recurso está completo, mas pode interagir mal com outras funcionalidades do shell. Se você encontrar algo incompatível, avise-nos!
</Info>

A integração com o shell envolve a sua sessão atual do shell para que o Devin seja executado junto com ela. Depois de configurada, você pode:

* Pressionar **Ctrl+G** (configurável) em qualquer lugar do seu shell para invocar o Devin com sua linha de comando atual como contexto
* Digitar `# <message>` e pressionar Enter para enviá-la diretamente ao Devin (somente Zsh)
* Dar ao Devin visibilidade automática sobre seus comandos recentes no shell e a saída deles

Recomendamos fortemente usar `zsh` em vez de `bash` ou `fish` para ter o melhor suporte.

***

<div id="setup">
  ## Configuração
</div>

Execute o comando de configuração para instalar a integração com o shell no arquivo de configuração do seu shell:

```bash theme={null}
devin shell setup
```

Isso adiciona blocos gerenciados ao arquivo rc do seu shell (`~/.bashrc`, `~/.zshrc` ou `~/.config/fish/config.fish`). Em seguida, reinicie o terminal ou carregue a configuração com `source`:

<Tabs>
  <Tab title="Bash">
    ```bash theme={null}
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="Zsh">
    ```bash theme={null}
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="Fish">
    ```fish theme={null}
    source ~/.config/fish/config.fish
    ```
  </Tab>
</Tabs>

Você também pode especificar explicitamente um shell:

```bash theme={null}
devin shell setup bash
devin shell setup zsh
devin shell setup fish
```

<Note>
  A integração com o shell é independente do assistente `devin setup`. Executar `devin setup` **não** instala a integração com o shell — você precisa executar `devin shell setup` separadamente.
</Note>

***

<div id="features">
  ## Recursos
</div>

<video controls className="w-full aspect-video" src="https://mintcdn.com/cognitionai/aB0LGhNhil-hGeEB/images/cli/devin4terminal.mp4?fit=max&auto=format&n=aB0LGhNhil-hGeEB&q=85&s=c87bfe2ff72b14fea8e939752f5da857" data-path="images/cli/devin4terminal.mp4" />

<div id="ctrlg-shortcut-configurable">
  ### Atalho Ctrl+G (configurável)
</div>

Pressione **Ctrl+G** em qualquer lugar no shell para chamar o Devin. Tudo o que você digitou na linha atual é enviado ao Devin como contexto, junto com o histórico recente do shell.

```bash theme={null}
$ git status   # digite isso, depois pressione Ctrl+G em vez de Enter
# Devin abre com "git status" como contexto + seu histórico recente do shell
```

Isso funciona em Bash, Zsh e Fish.

<div id="comment-syntax-zsh-only">
  ### Sintaxe de comentários (apenas no Zsh)
</div>

No Zsh, inicie uma linha com `#`, digite uma mensagem em linguagem natural e pressione Enter. O Devin recebe seu comentário como prompt.

```bash theme={null}
$ # explain what this directory contains
# Devin abre com seu comentário como o prompt
```

<Note>
  A sintaxe de comentários exige a opção `INTERACTIVE_COMMENTS` do Zsh, que a integração com o shell ativa automaticamente.
</Note>

<div id="shell-history-context">
  ### Contexto do histórico do shell
</div>

Quando acionado via Ctrl+G ou pela sintaxe de comentário, o Devin pode ver seus comandos recentes no shell *incluindo a saída deles*. Isso dá ao Devin mais contexto sobre o que você vem fazendo, para que ele possa oferecer ajuda mais relevante sem que você precise explicar.

***

<div id="removing-shell-integration">
  ## Removendo a integração com o shell
</div>

Para remover a integração com o shell, exclua os blocos gerenciados do arquivo de configuração do shell (`~/.bashrc`, `~/.zshrc` ou `~/.config/fish/config.fish`). Procure as linhas entre os marcadores `BEGIN MANAGED` e `END MANAGED` e remova todo esse bloco. Em seguida, reinicie o terminal.

***

<div id="setup">
  ## Configuração
</div>

Configure o comportamento da integração com o shell no seu [arquivo de configuração](/pt-BR/cli/reference/configuration/config-file):

```json theme={null}
// ~/.config/devin/config.json
{
  "shell": {
    "keybinding_trigger": "C-g",
    "enable_comments": true
  }
}
```

| Opção                      | Padrão  | Descrição                                                                                                                                            |
| -------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `shell.keybinding_trigger` | `"C-g"` | Atalho de teclado para acionar o Devin no shell. Use o prefixo `C-` para Ctrl (por exemplo, `"C-g"` para Ctrl+G). Defina como `null` para desativar. |
| `shell.enable_comments`    | `true`  | Ative a sintaxe `# comment` no Zsh para enviar mensagens ao Devin.                                                                                   |

<Note>
  Após alterar a configuração, execute `devin shell setup` novamente e reinicie o terminal para que as alterações entrem em vigor.
</Note>