Referência rápida para todos os comandos e flags do ChatCLI.
Comandos Internos (/)
| Comando | Descrição |
|---|
/help | Mostrar ajuda |
/exit ou /quit | Sair do ChatCLI |
/newsession | Iniciar nova sessão de conversa |
/config ou /status | Mostrar configuração atual |
/reload | Recarregar configurações do .env |
/switch | Trocar provedor de LLM ou modelo |
/agent ou /run | Iniciar modo agente |
/coder | Iniciar modo coder (engenharia de código) |
/auth | Gerenciar credenciais OAuth |
/clear | Redesenhar/limpar tela |
/connect | Conectar a servidor remoto (gRPC) |
/disconnect | Desconectar do servidor remoto |
/context | Gerenciar contextos persistentes |
/plugin | Gerenciar plugins |
/skill | Gerenciar skills de registries |
/session | Gerenciar sessões |
/nextchunk | Carregar próximo chunk de arquivo |
/retry | Retentar último chunk que falhou |
/retryall | Retentar todos os chunks que falharam |
/skipchunk | Pular um chunk de arquivo |
/version | Verificar versão |
/compact | Compactar historico de conversa (auto ou guiado) |
/rewind | Voltar a um checkpoint anterior da conversa |
/memory | Ver/carregar anotacoes de memoria (today, yesterday, week, load, longterm, list) |
/watch | Status do K8s watcher |
Comandos de Contexto (@)
| Comando | Descrição |
|---|
@file <caminho> | Anexa conteúdo de arquivo ou estrutura de diretório |
@file --mode <modo> | Modo: full, summary, chunked, smart |
@command <cmd> | Executa comando e anexa saída como contexto |
@command --ai | Envia saída direto para análise da IA |
@command -i | Modo interativo (ex: ssh, vim) |
@git | Injeta status, diff e log do repositório Git |
@env | Injeta variáveis de ambiente (sensíveis redactadas) |
@history | Injeta histórico de comandos do shell |
Modo Agente — Ações
| Ação | Descrição |
|---|
[N] | Executa comando de número N |
a | Executa todos os comandos pendentes |
eN | Edita o comando N |
tN | Simula (dry-run) o comando N |
cN | Pede continuação à IA com saída de N |
pcN | Adiciona contexto pré-execução |
acN | Adiciona contexto pós-execução |
vN | Visualiza saída completa em pager |
wN | Salva saída em arquivo temporário |
p | Alterna visão compacta/completa |
r | Redesenha a tela |
q | Sai do modo agente |
Sessões (/session)
| Comando | Descrição |
|---|
/session save <nome> | Salva a conversa atual |
/session load <nome> | Carrega uma conversa salva |
/session list | Lista todas as sessões |
/session delete <nome> | Deleta uma sessão |
/session new | Inicia sessão limpa |
Quando conectado a um servidor remoto, sessões podem ser salvas/carregadas local, remoto ou em ambos.
Contextos Persistentes (/context)
| Comando | Descrição |
|---|
/context create <nome> ... | Cria snapshot de arquivos/diretórios |
/context update <nome> ... | Atualiza contexto existente |
/context attach <nome> | Anexa contexto à sessão atual |
/context detach <nome> | Desanexa contexto |
/context list | Lista contextos salvos |
/context show <nome> | Mostra detalhes e arquivos |
/context inspect <nome> | Estatísticas detalhadas |
/context delete <nome> | Deleta permanentemente |
/context merge <novo> <c1> <c2> | Combina contextos |
/context attached | Mostra contextos anexados com estimativa de tokens e dicas de cache |
/context export <nome> <arq> | Exporta para JSON |
/context import <arq> | Importa de JSON |
/context metrics | Estatísticas de uso |
Skills (/skill)
| Comando | Descrição |
|---|
/skill search <query> | Busca em todos os registries (fan-out paralelo) |
/skill install <name> | Instala skill de um registry |
/skill uninstall <name> | Remove skill instalada |
/skill list | Lista skills instaladas |
/skill info <name> | Metadados de uma skill do registry |
/skill registries | Mostra registries configurados |
/skill help | Ajuda do comando /skill |
Flags de Linha de Comando (One-Shot)
| Flag | Descrição |
|---|
-p, --prompt | Executa um prompt e sai |
--provider <nome> | Sobrescreve provedor (ex: CLAUDEAI) |
--model <nome> | Sobrescreve modelo |
--timeout <duração> | Tempo limite (ex: 10s, 1m) |
--max-tokens <num> | Limita tokens na resposta |
--agent-auto-exec | Executa primeiro comando seguro no modo agente |
--no-anim | Desabilita animações (útil em scripts) |
-v, --version | Mostra versão |
-h, --help | Mostra ajuda |
Subcomandos
chatcli server
chatcli connect
chatcli watch
Inicia como servidor gRPC para acesso remoto.| Flag | Descrição | Padrão |
|---|
--port <int> | Porta gRPC | 50051 |
--token <string> | Token de autenticação | "" |
--tls-cert <path> | Certificado TLS | "" |
--tls-key <path> | Chave TLS | "" |
--provider <nome> | Provedor LLM padrão | Auto |
--model <nome> | Modelo padrão | Auto |
--watch-deployment <nome> | Deployment K8s a monitorar | "" |
--watch-namespace <ns> | Namespace | "default" |
--watch-interval <dur> | Intervalo de coleta | 30s |
--watch-window <dur> | Janela de observação | 2h |
--watch-max-log-lines <n> | Max linhas de log/pod | 100 |
--watch-kubeconfig <path> | Kubeconfig | Auto |
Conecta a um servidor remoto via gRPC.| Flag | Descrição | Padrão |
|---|
<address> | Endereço (posicional) | |
--addr <host:port> | Endereço (flag) | "" |
--token <string> | Token de autenticação | "" |
--provider <nome> | Sobrescreve provedor | "" |
--model <nome> | Sobrescreve modelo | "" |
--llm-key <string> | Sua API key | "" |
--use-local-auth | Usa OAuth do auth store local | false |
--tls | Habilita TLS | false |
--ca-cert <path> | Certificado CA | "" |
-p <prompt> | One-shot remoto | "" |
--raw | Saída sem formatação | false |
--max-tokens <int> | Max tokens | 0 |
Monitora deployment K8s com IA.| Flag | Descrição | Padrão |
|---|
--deployment <nome> | Deployment (obrigatório) | "" |
--namespace <ns> | Namespace | "default" |
--interval <dur> | Intervalo de coleta | 30s |
--window <dur> | Janela de observação | 2h |
--max-log-lines <n> | Max linhas de log/pod | 100 |
--kubeconfig <path> | Kubeconfig | Auto |
--provider <nome> | Provedor LLM | .env |
--model <nome> | Modelo LLM | .env |
-p <prompt> | One-shot com contexto K8s | "" |
--max-tokens <int> | Max tokens | 0 |
Compactacao e Rewind
| Comando | Descricao |
|---|
/compact | Compactacao automatica (pipeline de 3 niveis) |
/compact <instrucao> | Compactacao guiada — preserva informacoes especificas |
/rewind | Exibe menu de checkpoints para restaurar |
| Esc+Esc | Atalho rapido para /rewind (2x Esc em menos de 500ms, apenas com input vazio) |
O /compact aceita uma instrucao em linguagem natural. Exemplo: /compact preservar os caminhos de arquivo e decisoes.
Atalhos de Teclado
| Atalho | Ação |
|---|
| Alt/Option + setas | Mover cursor por palavra |
| Ctrl + setas | Mover cursor por palavra |
| Cmd + setas / Home/End | Início/fim da linha |
| Esc+Esc | Abrir menu de rewind (duplo Esc em menos de 500ms, apenas com input vazio) |
| Atalho | Ação |
|---|
| Alt + Backspace | Deletar palavra à esquerda |
| Ctrl + W | Deletar palavra à esquerda |
| Ctrl + K | Deletar do cursor ao fim da linha |
Detecção automática via Bracketed Paste Mode:
- Pastes pequenos (150 chars ou menos): renderizados normalmente
- Pastes grandes (mais de 150 chars): placeholder
«N chars | M lines»
O conteúdo real é preservado e enviado ao pressionar Enter. 
