Pular para o conteúdo principal

Modo Interativo

O modo padrão do ChatCLI é o interativo. Para iniciá-lo, basta executar:
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.
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 /.
ComandoDescrição
/helpExibe a tela de ajuda completa com todos os comandos e opções disponíveis
/menu (ou /)Abre a paleta de comandos interativa — lista navegável de todos os comandos (setas para navegar)
/exit ou /quitEncerra a aplicação de forma segura
/newsessionLimpa o histórico da conversa e inicia um novo diálogo do zero
/config ou /statusMostra a configuração atual: provedor, modelo ativo e variáveis (com valores sensíveis ocultos); bare abre a paleta com as seções
/reloadRecarrega as configurações do .env sem reiniciar a aplicação
/switchTroca o provedor ou modelo — bare abre a paleta navegável de provedores/flags
/providerTroca o provedor de LLM pelo nome — bare abre a paleta com os provedores ativos (mesma experiência do /model)
/compactCompacta o histórico de conversa (automático ou guiado com instrução)
/rewindVolta a um checkpoint anterior da conversa

Comandos Avançados

Comandos de Contexto (@)

Injetam informações dinâmicas no seu prompt: @file, @git, @command, @env, @history.

Modo Agente (/agent)

Delegue tarefas completas. A IA planeja e executa comandos com sua aprovação.

Modo Coder (/coder)

IA que lê, edita, aplica patches e roda testes em loop — com rollback automático.

Controle de Conversa

Use /compact para compactar e /rewind (ou Esc+Esc) para voltar no tempo.

Skills e Plugins

Estenda o ChatCLI com plugins customizados e skills de registries remotos.

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.
/coder corrija os testes falhando
<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}}'/>
No /coder, sempre é a IA quem emite os comandos @coder — você apenas descreve o objetivo.
Veja os guias completos: Modo Coder e Plugin @coder
O ChatCLI suporta atalhos de teclado para navegação eficiente:
AtalhoAção
Alt/Option + setasMover cursor por palavra
Ctrl + setasMover cursor por palavra
Cmd + setas / Home/EndMover para início/fim da linha
Alt + BackspaceDeletar palavra à esquerda
Esc+EscAbrir menu de rewind (duplo Esc em menos de 500ms, apenas com input vazio)
/ ou /menu + EnterAbrir a paleta de comandos (setas para navegar, Enter para selecionar)
Para a lista completa, veja a Referência de Comandos.

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

Comandos de Contexto

Aprenda a injetar contexto do seu ambiente no prompt.

Modo Agente

Delegue tarefas completas para a IA executar.