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

Comandos Internos (/)

ComandoDescrição
/helpMostrar ajuda
/menu (ou /)Abre a paleta de comandos interativa — lista navegável de todos os comandos (ver Paleta de Comandos)
/exit ou /quitSair do ChatCLI
/newsessionIniciar nova sessão de conversa
/config, /status ou /settingsPanorama da configuração (aceita subseções — ver abaixo); bare abre a paleta com as seções
/reloadRecarregar configurações do .env — inclui o provider de embeddings (CHATCLI_EMBED_*): trocar para bedrock/voyage/openai passa a valer sem reiniciar
/switchTrocar provedor de LLM ou modelo (com autocomplete dinâmico); bare abre a paleta de provedores/flags
/provider (ou /providers)Troca o provedor de LLM ativo pelo nome; bare abre a paleta com os provedores ativos (mesma experiência do /model)
/model <nome>Atalho para /switch --model <nome>; bare abre a paleta com os modelos disponíveis
/max-tokens <num>Atalho para /switch --max-tokens <num>; sem argumento mostra o valor atual
/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, search)
/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/editar memória (today, yesterday, week, load, longterm, list, profile, profile set <campo>=<valor>, remember <fato>, forget <trecho>, 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)
/channelMCP channels inbox + trigger engine — ver /channel subcomandos
/websearchGerenciar provider de busca web (status, list, provider, reset)
/thinkingOverride cross-provider de reasoning/thinking (on|off|auto|low|medium|high|max|budget=N) — ver #7 Reasoning Backbone
/planForça Plan-and-Solve / ReWOO no próximo /agent ou /coder — ver #2 Plan-and-Solve
/refineToggle do Self-Refine na sessão (on|off|once|auto) — ver #5 Self-Refine
/verifyToggle do Chain-of-Verification na sessão (on|off|once|auto) — ver #6 CoVe
/reflectFila durável de lições (status, list, failed, retry, purge, drain) — ver #3 Reflexion
/scheduleAgenda um job durável (cron / relative / interval / wait-until) — ver Scheduler
/waitAguarda uma condição e opcionalmente dispara ação — ver Scheduler
/jobsGerencia jobs agendados (list, show, tree, cancel, pause, resume, logs, history, daemon, gc)
/parkedLista agents estacionados via @parkprune limpa terminais, gc <dur> limpa antigos — ver Agent Park & Resume
/resume/resume <token> força retomada imediata de um park (idempotente contra auto-resume)
/cancel-park/cancel-park <token> aborta um park: deleta snapshot + cancela job no scheduler
/ratelimit ou /limitsMostra os limites de taxa do provider atual, parseados dos headers x-ratelimit-* da última resposta (requests/tokens restantes e reset)
/exportExporta a trajetória do agente da sessão atual como JSONL no formato ShareGPT (fine-tuning / análise)
/moaMixture-of-Agents: vários modelos propõem em paralelo e um agregador sintetiza (CHATCLI_MOA_MODELS) — ver Mixture-of-Agents
/gatewayRoda o ChatCLI como daemon de mensageria desacoplado (start, status, stop): cada mensagem passa pelo agent loop e o progresso é transmitido via Telegram/Slack/Discord/WhatsApp/webhook — ver Chat Gateway
/hubInspeciona e gerencia a conversa compartilhada cross-channel: whoami (principal + conversa ativa), bind <plataforma> <userid> [principal], bindings [principal] — ver Conversation Hub
/lsp <arquivo>Diagnósticos de código (erros/avisos) de um arquivo via Language Server Protocol — ver Diagnósticos LSP

Paleta de Comandos Interativa

Comandos com subcomandos, flags ou valores abrem uma paleta navegável quando digitados sem argumentos e confirmados com Enter — a mesma experiência de quem usa Claude Code. Em vez de só imprimir uma lista, a paleta deixa você navegar com as setas e selecionar.
Como abrirResultado
/ ou /menu + EnterPaleta raiz: todos os comandos agrupados por categoria
Um comando “pickável” bare (ex.: /model, /config, /provider, /switch) + EnterPaleta escopada àquele comando: seus subcomandos/flags/valores reais
Os itens vêm ao vivo do mesmo motor de autocomplete do prompt — modelos, sessões, seções de config, provedores, arquivos — então a paleta e o <TAB> sempre mostram exatamente o mesmo conjunto, sem divergência. Navegação na paleta:
TeclaAção
/ (ou Ctrl+P / Ctrl+N)Mover a seleção
DigitarFiltrar (fuzzy)
/ EnterEntrar no subnível ou selecionar (executa o comando)
TabInserir a seleção como texto
/ Esc / BackspaceVoltar um nível (ou cancelar na raiz)
Ctrl+CCancelar
Entrada “executar como está” (): todo picker escopado começa com uma entrada que executa o comando sem argumentos, preservando o comportamento de comandos cujo bare já fazia algo — por exemplo /config mostra o panorama, /switch abre o seletor de provedor. A descrição dessa entrada resume o que o comando faz, então ele nunca parece “vazio”. A paleta é temática (segue o tema ativo, ver /config ui theme) e roda só no REPL interativo — execuções headless (scheduler, gateway, one-shot) rodam o comando como digitado.

Subcomando externo chatcli daemon

chatcli daemon {start|stop|status|ping|install} [--detach] [--socket <path>] — controla o scheduler daemon em background. Qualquer CLI interativo detecta o daemon e vira thin client via UNIX socket. Veja Scheduler → Daemon mode.

Subcomandos externos chatcli mcp-server e chatcli acp

chatcli mcp-server (alias mcp-serve) — roda o ChatCLI como servidor MCP sobre stdio. Além de chat (ask_chatcli), expõe o agent loop (agent_task), o coder (coder_task) e as built-in tools curadas (read, search, tree, websearch, webfetch), permitindo que um cliente MCP dirija a funcionalidade real do ChatCLI. Use LLM_PROVIDER/LLM_MODEL para escolher o backend. Ver MCP Server (ChatCLI como servidor). chatcli acp — roda o ChatCLI sobre o Agent Client Protocol (stdio), para integração com editores que falam ACP.

/config security — rules mutáveis

O /config security agora é hierárquico: a forma sem subcomando continua mostrando o panorama; os subcomandos novos mutam o PolicyManager ao vivo e persistem em ~/.chatcli/coder_policy.json. Usado tanto pelo /coder interativo quanto pelo scheduler no preflight.
SubcomandoDescrição
/config securityDump read-only (comportamento anterior)
/config security rulesLista rules ativas agrupadas por ação (deny, allow, ask)
/config security allow "<pattern>" [--yes]Adiciona rule ALLOW; confirma se o pattern é amplo
/config security deny "<pattern>" [--yes]Adiciona rule DENY; confirma [y/N]
/config security forget "<pattern>" [--yes]Remove rule; confirma [y/N]
/config security reloadForça re-read do JSON (após edição externa do arquivo)
Patterns usam prefix match sobre <toolName> <args> como o PolicyManager normaliza (@coder exec <cmd>). Deny sempre bate allow.

/channel — MCP channels inbox e triggers

Gerencia o inbox de MCP Channels e o trigger engine (rules em ~/.chatcli/mcp/triggers.json). Todos os subcomandos suportam autocomplete (Tab após /channel ).
SubcomandoArgumentoDescrição
/channel ou /channel listLista até 20 mensagens mais recentes do ring com seq, timestamp, servidor, channel e preview. Mostra contadores total e unread, mais um aviso quando o engine está pausado
/channel <name>nome de channelFiltra a listagem pelas mensagens daquele channel
/channel ackMarca todas as mensagens como lidas, limpa o banner de notify pendentes. Retorna quantas entradas foram limpas
/channel injectInjeta as últimas 10 mensagens no histórico como uma system message (legado preservado). Útil quando você quer dar contexto explícito sem esperar a auto-injection das 5 mais recentes
/channel pausePausa o trigger engine. Mensagens continuam entrando no ring/persistência, mas nenhuma Action é emitida (zero banners, confirms, autos) enquanto pausado
/channel resumeReativa o trigger engine
/channel rulesLista rules ativas com nome, modo, filtros (server/channel/contentRegex) e configs (rate, dedup, tools)
/channel rules reloadRe-lê ~/.chatcli/mcp/triggers.json. Se houver erro de schema, mantém as rules anteriores ativas e mostra o erro
/channel confirm <id>id obrigatórioAceita uma Action confirm pendente (default = yes); roda o agent no template da rule dentro de uma AUTO-AGENT envelope box
/channel confirm <id> noid obrigatórioRecusa uma Action confirm pendente sem disparar nada
/channel run <seq>seq obrigatórioDispara o agent manualmente em cima de uma mensagem específica do ring (pegue o seq em /channel list) — útil pra investigar uma mensagem que entrou como notify
Schema das rules e exemplos completos: MCP Config — Trigger rules.

Harness/Pipeline de Qualidade — Atalhos

O ChatCLI implementa sete padrões de agente LLM que podem ser ligados/desligados por sessão via slashes:
PadrãoSlashDefaultO que faz
#1 ReActsempre onLoop base
#2 Plan-and-Solve/planauto (complexity ≥ 6)Plano JSON + ReWOO
#3 Reflexion/reflecton (em erros)Lições persistidas
#4 RAG + HyDEoffRetrieval semântico
#5 Self-Refine/refine onoffCritique + rewrite
#6 CoVe/verify onoffChain-of-Verification
#7 Reasoning/thinking onauto (planner, refiner, verifier, reflexion)Cross-provider
Referência completa: Harness/Pipeline de Qualidade do Agente · Configuração

/reflect — subcomandos

A fila durável de Reflexion expõe operações de observabilidade e triagem da DLQ. Todos têm autocomplete via Tab:
SubcomandoO que faz
/reflectStatus: queue depth + DLQ size + hint dos subcomandos
/reflect <texto livre>Persiste lição manual em memory.Fact (sem LLM)
/reflect listLista pendentes + DLQ com trigger, attempts, age, task preview
/reflect failedSó DLQ, com último erro — ideal pra triagem
/reflect retry <job-id>Reenfileira job da DLQ (reseta Attempts=0) — Tab autocompleta IDs vivos
/reflect purge <job-id>Remove definitivo da DLQ — Tab autocompleta IDs vivos
/reflect drainForça replay do WAL (pendências de sessão anterior)
Tab em /reflect retry ou /reflect purge consulta a DLQ viva e mostra IDs com preview da task + último erro.

/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, Moonshot, 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, confiança TLS global (CA bundle, skip-verify), 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 qualityPipeline dos sete padrões: Self-Refine, CoVe, Reflexion, Plan-First, HyDE (vetores + provider + contagem), Reasoning backbone — ver overview completo
/config serverCondicional — só renderiza se alguma env de server mode estiver setada (gRPC, JWT, rate limit, fallback chain, watcher, audit, operator)
/config hubConversation Hub: valor efetivo de cada setting (com a fonte — setting/env/default), bindings, e estado da sessão. Mutável — ver abaixo
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.

/config hub — settings mutáveis

Diferente de /config hub puro (panorama read-only), os subcomandos mudam as settings do hub em runtime — persistidas no hub.db e lidas ao vivo pelo daemon do gateway (cross-process, sem restart):
ComandoEfeito
/config hub set enabled <on|off>Liga/desliga o hub
/config hub set principal <nome>Define a identidade compartilhada da conversa
/config hub set isolate <on|off>Isola cada canal (bot multi-usuário) vs. colapsar no principal
/config hub set ttl_hours <n>Horas até podar conversa ociosa (0 desativa)
/config hub reset <chave>Remove o override; volta a env var/default
Precedência: setting (db) > env var > default. O /config hub reimprime na hora após cada set/reset, mostrando o novo valor e a fonte. Mutação exige hub local ou /connect.

/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|brave|mojeek|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), searxng (self-hosted via SEARXNG_URL), brave e mojeek (índices independentes, scraping HTML). Cadeia default: duckduckgo → searxng → brave → mojeek. Ver Web Tools para detalhes.

Troca de Provedor e Modelo (/switch)

ComandoDescrição
/switchBare abre a paleta de provedores/flags; também aceita as flags abaixo
/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)
/provider <nome>Troca o provedor ativo pelo nome (case-insensitive); bare abre a paleta com os provedores ativos
/providersAlias de /provider
/model <nome>Atalho de /switch --model <nome> (bare abre a paleta com os modelos)
/max-tokens <num>Atalho de /switch --max-tokens <num> (sem argumento, mostra o valor atual)
O autocomplete de /switch --model (e de /model) busca modelos diretamente da API do provedor usando o token/key ativa. Cada sugestão mostra [API] (dinâmico) ou [catalog] (estático). /model e /max-tokens delegam ao /switch, então compartilham exatamente a mesma validação e comportamento. /provider é o equivalente navegável do seletor de provedor: digite /provider e Enter para abrir a paleta com os provedores ativos (o atual marcado), escolha um e a troca é aplicada — a mesma lógica de troca do /switch, só que pelo nome em vez do índice numérico.
# Exemplos
/switch                      # Paleta de provedores/flags
/switch --model gpt-4o       # Troca para GPT-4o
/provider                    # Paleta com os provedores ativos
/provider OPENAI             # Troca direto para o provedor OPENAI
/model gpt-4o-mini           # Mesmo que /switch --model gpt-4o-mini
/model                       # Paleta com os modelos disponíveis (source: API ou catalog)
/max-tokens 4096             # Mesmo que /switch --max-tokens 4096
/max-tokens                  # Mostra o limite atual de max-tokens
Os atalhos /model, /provider e /max-tokens aparecem no menu de comandos (<TAB> após /) e têm autocomplete próprio — /model <TAB> sugere os modelos do provedor ativo, /provider <TAB> lista os provedores e /max-tokens <TAB> oferece presets (0, 1024, 4096, 8192, 16384, 32768).

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

Plugins LLM-callable (@<tool>)

Tools que o agente pode invocar via <tool_call> (modos /agent, /coder). Catálogo completo em Plugin System e Tools Atômicos.
PluginSubcomandosDoc
@coderread, write, patch, multipatch, tree, search, exec, test, rollback, git-status, git-diff, git-log, git-changed, git-branch, cleanPlugin @coder
@read(flat) file, from_line, to_line, head, tail, encodingTools Atômicos
@search(flat) term, dir, max_results, includeTools Atômicos
@tree(flat) dir, depth, excludeTools Atômicos
@todowrite, list, markTools Atômicos
@websearchsearchWeb Tools
@webfetchfetchWeb Tools
@schedulerschedule, wait, query, list, cancelScheduler
@parkdelay, until, for_url, for_cmdAgent Park

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
/session search <termo>Busca full-text nas sessões salvas e mostra trechos com o termo destacado
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 (--mode knowledge indexa corpora de docs como knowledge base)
/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 pin <name>Fixa uma skill na sessão — injetada em todo turno até /skill unpin
/skill unpin <name>Remove uma skill do conjunto fixado
/skill pinnedLista as skills fixadas na sessão atual
/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 (nome, função, empresa, localização, skills, certificações, metas)
/memory profile set <campo>=<valor>Define/atualiza um campo do perfil manualmente (ex.: certifications=CKA, company=ACME). Campos de lista acumulam e deduplicam
/memory remember <fato>Adiciona um fato de longo prazo explicitamente (aceita prefixo [categoria])
/memory forget <trecho>Remove fatos de longo prazo que contenham o trecho informado
/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