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

# Uso Básico e Comandos Principais

> Aprenda a interagir com o ChatCLI e a usar os comandos essenciais para navegação, configuração e controle.

## Modo Interativo

O modo padrão do ChatCLI é o interativo. Para iniciá-lo, basta executar:

```bash theme={"system"}
chatcli
```

Você verá uma tela de boas-vindas e um prompt ( `❯` ), pronto para receber suas perguntas ou comandos. Qualquer texto que não comece com `/` ou `@` será tratado como um prompt para a IA.

```bash theme={"system"}
me ajude a listar todos os containers docker ativos
```

***

## Comandos Essenciais

Os comandos internos são seu centro de controle. Eles sempre começam com `/`.

| Comando | Descrição |
| - | - |
| `/help` | Lista todos os comandos por categoria, com aliases; `/help <comando>` mostra os subcomandos e opções daquele comando |
| `/menu` (ou `/`) | Abre a paleta de comandos interativa — lista navegável de todos os comandos (setas para navegar) |
| `/exit` ou `/quit` | Encerra a aplicação de forma segura |
| `/newsession` | Limpa o histórico da conversa e inicia um novo diálogo do zero |
| `/config` ou `/status` | Mostra a configuração atual: provedor, modelo ativo e variáveis (com valores sensíveis ocultos); bare abre a paleta com as seções |
| `/reload` | Recarrega as configurações do `.env` sem reiniciar a aplicação |
| `/switch` | Troca o provedor ou modelo — bare abre a paleta navegável de provedores/flags |
| `/provider` | Troca o provedor de LLM pelo nome — bare abre a paleta com os provedores ativos (mesma experiência do `/model`) |
| `/compact` | Compacta o histórico de conversa (automático ou guiado com instrução) |
| `/rewind` | Volta a um checkpoint anterior da conversa |

***

## Comandos Avançados

<CardGroup cols={2}>
  <Card title="Comandos de Contexto (@)" icon="at" href="/pt/usage/context-commands">
    Injetam informações dinâmicas no seu prompt: `@file`, `@git`, `@command`, `@env`, `@history`.
  </Card>

  <Card title="Modo Agente (/agent)" icon="robot" href="/pt/usage/agent-mode">
    Delegue tarefas completas. A IA planeja e executa comandos com sua aprovação.
  </Card>

  <Card title="Modo Coder (/coder)" icon="code" href="/pt/usage/coder-mode">
    IA que lê, edita, aplica patches e roda testes em loop — com rollback automático.
  </Card>

  <Card title="Controle de Conversa" icon="clock-rotate-left" href="/pt/usage/conversation-control">
    Use `/compact` para compactar e `/rewind` (ou Esc+Esc) para voltar no tempo.
  </Card>

  <Card title="Skills e Plugins" icon="plug" href="/pt/extensions/plugin-system">
    Estenda o ChatCLI com plugins customizados e skills de registries remotos.
  </Card>
</CardGroup>

***

## Modo Coder (/coder)

O modo `/coder` é especializado para engenharia de software. A IA chama ferramentas automaticamente em um loop de leitura, edição e testes.

```bash theme={"system"}
/coder corrija os testes falhando
```

```xml theme={"system"}
<tool_call name="@coder" args='{"cmd":"tree","args":{"dir":"."}}'/>
<tool_call name="@coder" args='{"cmd":"search","args":{"term":"FAIL","dir":"."}}'/>
<tool_call name="@coder" args='{"cmd":"read","args":{"file":"cli/agent_mode.go"}}'/>
<tool_call name="@coder" args='{"cmd":"test","args":{"dir":"."}}'/>
<tool_call name="@coder" args='{"cmd":"git-diff","args":{"dir":".","stat":true}}'/>
```

<Info>
  No `/coder`, sempre é a IA quem emite os comandos `@coder` — você apenas descreve o objetivo.
</Info>

Veja os guias completos: [Modo Coder](/pt/usage/coder-mode) e [Plugin @coder](/pt/coder/coder-plugin)

***

## Navegação no Prompt

O ChatCLI suporta atalhos de teclado para navegação eficiente:

| Atalho | Ação |
| - | - |
| **Alt/Option + setas** | Mover cursor por palavra |
| **Ctrl + setas** | Mover cursor por palavra |
| **Cmd + setas** / **Home/End** | Mover para início/fim da linha |
| **Alt + Backspace** | Deletar palavra à esquerda |
| **Esc+Esc** | Abrir menu de rewind (duplo Esc em menos de 500ms, apenas com input vazio) |
| **`/` ou `/menu` + Enter** | Abrir a paleta de comandos (setas para navegar, Enter para selecionar) |

Para a lista completa, veja a [Referência de Comandos](/pt/reference/command-reference#atalhos-de-teclado).

***

## Detecção Inteligente de Paste

O ChatCLI detecta automaticamente texto colado via *Bracketed Paste Mode*. Para pastes grandes (mais de 150 caracteres), o conteúdo é substituído por um placeholder compacto no prompt:

```text theme={"system"}
«1234 chars | 5 lines»
```

O conteúdo real é preservado internamente e enviado integralmente ao pressionar Enter. Pastes pequenos (150 caracteres ou menos) são renderizados normalmente.

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Comandos de Contexto" icon="at" href="/pt/usage/context-commands">
    Aprenda a injetar contexto do seu ambiente no prompt.
  </Card>

  <Card title="Modo Agente" icon="robot" href="/pt/usage/agent-mode">
    Delegue tarefas completas para a IA executar.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.