Pular para o conteúdo principal
Referência rápida para todos os comandos e flags do ChatCLI.

​
Comandos Internos (/)

ComandoDescrição
/helpMostrar ajuda
/exit ou /quitSair do ChatCLI
/newsessionIniciar nova sessão de conversa
/config, /status ou /settingsPanorama da configuração (aceita subseções — ver abaixo)
/reloadRecarregar configurações do .env
/switchTrocar provedor de LLM ou modelo (com autocomplete dinâmico)
/agent ou /runIniciar modo agente
/coderIniciar modo coder (engenharia de código)
/authGerenciar credenciais OAuth
/clearRedesenhar/limpar tela
/connectConectar a servidor remoto (gRPC)
/disconnectDesconectar do servidor remoto
/contextGerenciar contextos persistentes
/pluginGerenciar plugins
/skillGerenciar skills de registries
/sessionGerenciar sessões (save, load, list, delete, new, fork)
/nextchunkCarregar próximo chunk de arquivo
/retryRetentar último chunk que falhou
/retryallRetentar todos os chunks que falharam
/skipchunkPular um chunk de arquivo
/versionVerificar versão
/compactCompactar histórico de conversa (auto ou guiado)
/rewindVoltar a um checkpoint anterior da conversa
/memoryVer/carregar anotações de memória (today, yesterday, week, load, longterm, list, profile, topics, projects, stats, facts, compact)
/watchStatus do K8s watcher
/mcpGerenciar servidores MCP (status, tools, restart)
/hooksListar hooks de lifecycle configurados
/costExibir custo estimado da sessão atual
/worktreeGerenciar git worktrees (create, list, remove, status)
/channelMensagens de MCP channels (list, inject, <nome>)
/websearchGerenciar provider de busca web (status, list, provider, reset)

​
/config — Panorama e Seções

/config (alias: /status, /settings) tem dois modos: panorama curto (sem argumento — default) e drill-down por seção. Autocomplete de /config <TAB> lista as seções.
ComandoDescrição
/configPanorama curto: provider, modelo, sessão (mensagens, tokens, custo, duração), persona ativa, contadores (plugins, MCP servers, hooks), cadeia de websearch, conexão remota se ativa
/config allDump completo — todas as seções em sequência
/config general.env path, locale, logging, version check, history file
/config providersEnv vars de cada provider (OpenAI, Claude, Bedrock, Copilot, GitHub Models, OpenRouter, ZAI, MiniMax, StackSpot, Ollama) + presença de API keys (sem vazar valores)
/config agentRuntime do modo agente: coder UI, workers, subagents, timeouts, tmpdir, denial caps, per-agent overrides, persona ativa
/config resiliencePayload caps, recovery ladder, stream timeout, proxy Bedrock (CA bundle, IMDS), compactação
/config sessionSessão atual (nome, mensagens, custo, budget), contextos anexados, sistema de memória
/config integrationsMCP (servers + tool count), hooks, plugins, skill registries, websearch (cadeia ativa), worktrees (se em repo git), watcher K8s, conexão remota
/config authStatus OAuth por provider (anthropic, openai-codex, github-copilot, github-models) com expiração do token, keychain backend
/config securityPolítica de comandos (allow/denylist, sudo), sandbox de workspace, política do Coder, TLS/proxy, redação
/config serverCondicional — só renderiza se alguma env de server mode estiver setada (gRPC, JWT, rate limit, fallback chain, watcher, audit, operator)
O panorama mostra um resumo numérico (“MCP servers: 2 (6 tools)”, “Hooks: 3”, “Web search chain: duckduckgo → searxng”) e no rodapé lista as seções disponíveis. Use /config <section> para o detalhe completo.

​
/websearch — Provider de Busca Web

ComandoDescrição
/websearch ou /websearch statusMostra provider atual + cadeia de fallback ativa
/websearch listLista providers conhecidos e quais estão configurados
/websearch provider <searxng|duckduckgo|auto>Define provider preferido para a sessão (seta CHATCLI_WEBSEARCH_PROVIDER)
/websearch resetRemove override e volta ao modo auto
Providers suportados são keyless: duckduckgo (default, scraping HTML) e searxng (self-hosted via SEARXNG_URL). Ver Web Tools para detalhes.

​
Troca de Provedor e Modelo (/switch)

ComandoDescrição
/switchMenu interativo para trocar provedor
/switch --model <nome>Troca o modelo do provedor ativo
/switch --modelLista todos os modelos disponíveis (dinâmico da API)
/switch --max-tokens <num>Define máximo de tokens para respostas
/switch --realm <nome>Altera realm/tenant (apenas StackSpot)
/switch --agent-id <id>Altera agent (apenas StackSpot)
O autocomplete de /switch --model busca modelos diretamente da API do provedor usando o token/key ativa. Cada sugestão mostra [API] (dinâmico) ou [catalog] (estático). 
# Exemplos
/switch                      # Menu de provedores
/switch --model gpt-4o       # Troca para GPT-4o
/switch --model              # Lista modelos disponíveis (source: API ou catalog)
/switch --max-tokens 4096    # Define limite de tokens

​
Comandos de Contexto (@)

ComandoDescriçã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 --aiEnvia saída direto para análise da IA
@command -iModo interativo (ex: ssh, vim)
@gitInjeta status, diff e log do repositório Git
@envInjeta variáveis de ambiente (sensíveis redactadas)
@historyInjeta histórico de comandos do shell

​
Modo Agente — Ações

AçãoDescrição
[N]Executa comando de número N
aExecuta todos os comandos pendentes
eNEdita o comando N
tNSimula (dry-run) o comando N
cNPede continuação à IA com saída de N
pcNAdiciona contexto pré-execução
acNAdiciona contexto pós-execução
vNVisualiza saída completa em pager
wNSalva saída em arquivo temporário
pAlterna visão compacta/completa
rRedesenha a tela
qSai do modo agente

​
Sessões (/session)

ComandoDescrição
/session save <nome>Salva a conversa atual
/session load <nome>Carrega uma conversa salva
/session listLista todas as sessões
/session delete <nome>Deleta uma sessão
/session newInicia sessão limpa
/session fork <nome>Cria fork independente da sessão atual
Quando conectado a um servidor remoto, sessões podem ser salvas/carregadas local, remoto ou em ambos.

​
Contextos Persistentes (/context)

ComandoDescriçã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 listLista 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 attachedMostra contextos anexados com estimativa de tokens e dicas de cache
/context export <nome> <arq>Exporta para JSON
/context import <arq>Importa de JSON
/context metricsEstatísticas de uso

​
Skills (/skill)

ComandoDescrição
/skill search <query>Busca em todos os registries (fan-out paralelo)
/skill install <name> [--from <reg>]Instala skill de um registry (específico ou auto-detect)
/skill uninstall <name>Remove skill instalada (disambigua se múltiplas sources)
/skill listLista skills instaladas com source e versão
/skill info <name> [--from <reg>]Metadados completos (installs, security audits)
/skill registriesMostra registries configurados e status
/skill registry enable <name>Ativa um registry (hot-reload imediato)
/skill registry disable <name>Desativa um registry (hot-reload imediato)
/skill prefer [name] [source]Define/mostra preferência de source para skills com conflito
/skill prefer <name> --resetRemove preferência (volta ao padrão: local ganha)
/skill helpAjuda do comando /skill

​
Flags de Linha de Comando (One-Shot)

FlagDescrição
-p, --promptExecuta 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-execExecuta primeiro comando seguro no modo agente
--no-animDesabilita animações (útil em scripts)
-v, --versionMostra versão
-h, --helpMostra ajuda

​
Subcomandos

Inicia como servidor gRPC para acesso remoto.
FlagDescriçãoPadrão
--port <int>Porta gRPC50051
--token <string>Token de autenticação""
--tls-cert <path>Certificado TLS""
--tls-key <path>Chave TLS""
--provider <nome>Provedor LLM padrãoAuto
--model <nome>Modelo padrãoAuto
--watch-deployment <nome>Deployment K8s a monitorar""
--watch-namespace <ns>Namespace"default"
--watch-interval <dur>Intervalo de coleta30s
--watch-window <dur>Janela de observação2h
--watch-max-log-lines <n>Max linhas de log/pod100
--watch-kubeconfig <path>KubeconfigAuto

​
Memória

ComandoDescrição
/memory ou /memory todayMostra as notas de hoje
/memory yesterdayMostra as notas de ontem
/memory <data>Mostra notas de uma data (YYYY-MM-DD, YYYYMMDD, DD/MM/YYYY)
/memory weekNotas dos últimos 7 dias
/memory longtermConteúdo do MEMORY.md (fatos de longo prazo)
/memory listLista todos os arquivos de memória (inclui JSONs estruturados)
/memory load <data>Carrega notas no contexto da conversa
/memory profilePerfil do usuário detectado automaticamente
/memory topicsTópicos recorrentes rastreados
/memory projectsProjetos rastreados com status
/memory statsEstatísticas de uso (sessões, horas de pico, erros, features)
/memory facts [categoria]Fatos com scores (filtro: architecture, pattern, preference, gotcha, project, personal)
/memory compactForça compactação de memória (LLM + limpeza de notas antigas)

​
Compactação e Rewind

ComandoDescrição
/compactCompactação automática (pipeline de 3 níveis)
/compact <instrução>Compactação guiada — preserva informações específicas
/rewindExibe menu de checkpoints para restaurar
Esc+EscAtalho rápido para /rewind (2x Esc em menos de 500ms, apenas com input vazio)
O /compact aceita uma instrução em linguagem natural. Exemplo: /compact preservar os caminhos de arquivo e decisões.

​
Atalhos de Teclado