Referência Completa de Comandos

Referência rápida para todos os comandos e flags do ChatCLI.

Comandos Internos (`/`)

Comando	Descrição
`/help`	Mostrar ajuda
`/menu` (ou `/`)	Abre a paleta de comandos interativa — lista navegável de todos os comandos (ver Paleta de Comandos)
`/exit` ou `/quit`	Sair do ChatCLI
`/newsession`	Iniciar nova sessão de conversa
`/config`, `/status` ou `/settings`	Panorama da configuração (aceita subseções — ver abaixo); bare abre a paleta com as seções
`/reload` (alias `/config --reload`)	Recarregar configurações do `.env` — cobre todas as variáveis de provider (chaves, modelos, overrides de endpoint, `BEDROCK_PROVIDER`) e o provider de embeddings (`CHATCLI_EMBED_*`); valores removidos do `.env` são limpos sem reiniciar
`/switch`	Trocar 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 `/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
`/<comando>`	Invoca um template de slash command de `.chatcli/commands` (projeto ou `~/.chatcli/commands`, com interop de 9 ecossistemas de CLI de agente — Claude Code, Devin, Windsurf, Cursor, opencode, Codex, Gemini, Qwen, Copilot): `/review-pr 1326`. `/config commands` lista o catálogo
`/session`	Gerenciar sessões (`save`, `load`, `attach`, `detach`, `status`, `list`, `delete`, `new`, `fork`, `search`)
`/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`	Card de versão: build instalado, canal de instalação, última release e novidades quando há atualização
`/update`	Atualiza o ChatCLI pelo mesmo canal em que foi instalado (Homebrew, go install ou binário da release); `/update check` só verifica
`/compact`	Compactar histórico de conversa (auto ou guiado)
`/rewind`	Voltar a um checkpoint anterior da conversa
`/memory`	Ver/carregar/editar memória (today, yesterday, week, load, longterm, list, profile, `profile set <campo>=<valor>`, `remember <fato>`, `forget <trecho>`, topics, projects, stats, facts, `timeline [q]`, compact)
`/graph`	Renderiza o grafo de conhecimento em imagem (PNG, via go-graphviz embarcado). `/graph` = grafo completo; `/graph <assunto>` = grafo local de um nó
`/watch`	Status do K8s watcher
`/mcp`	Gerenciar servidores MCP (`status`, `tools`, `restart`)
`/hooks`	Listar hooks de lifecycle configurados
`/cost`	Exibir custo estimado da sessão atual
`/worktree`	Gerenciar git worktrees (`create`, `list`, `remove`, `status`)
`/channel`	MCP channels inbox + trigger engine — ver `/channel` subcomandos
`/websearch`	Gerenciar provider de busca web (`status`, `list`, `provider`, `reset`)
`/policy`	Modo de política de segurança da sessão (`status`, `mode auto`, `mode interactive`) — veja Modo de Política da Sessão
`/thinking`	Override cross-provider de reasoning/thinking (`on\|off\|auto\|low\|medium\|high\|max\|budget=N`) — ver #7 Reasoning Backbone
`/plan`	Força Plan-and-Solve / ReWOO no próximo `/agent` ou `/coder` — ver #2 Plan-and-Solve
`/refine`	Toggle do Self-Refine na sessão (`on\|off\|once\|auto`) — ver #5 Self-Refine
`/verify`	Toggle do Chain-of-Verification na sessão (`on\|off\|once\|auto`) — ver #6 CoVe
`/reflect`	Fila durável de lições (status, list, failed, retry, purge, drain) — ver #3 Reflexion
`/schedule`	Agenda um job durável (cron / relative / interval / wait-until) — ver Scheduler
`/wait`	Aguarda uma condição e opcionalmente dispara ação — ver Scheduler
`/jobs`	Gerencia jobs agendados (`list`, `show`, `tree`, `cancel`, `pause`, `resume`, `logs`, `history`, `daemon`, `gc`)
`/agents`	Runs de agents ao vivo em árvore (`list`, `show <id>`, `cancel <id>`) — ver Agent Squad
`/board`	Board de trabalho do time (`list`, `show`, `create`, `move`, `assign`, `note`, `archive`) — ver Agent Squad
`/mail`	Mensagens do time (`list`, `send <agent> <texto>`, `pending`) — ver Agent Squad
`/parked`	Lista agents estacionados via `@park` — `prune` 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
`/park-note`	`/park-note <mensagem>` envia uma diretiva ao agent estacionado — entregue como instrução quando ele retoma
`/ratelimit` ou `/limits`	Mostra os limites de taxa do provider atual, parseados dos headers `x-ratelimit-*` da última resposta (requests/tokens restantes e reset)
`/export`	Exporta a trajetória do agente da sessão atual como JSONL no formato ShareGPT (fine-tuning / análise)
`/moa`	Mixture-of-Agents: vários modelos propõem em paralelo e um agregador sintetiza; cada participante recebe o briefing de um turno de chat + tools read-only (knowledge, recall de CCR, memória) (`CHATCLI_MOA_MODELS`) — ver Mixture-of-Agents
`/gateway`	Roda 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
`/hub`	Inspeciona 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 abrir	Resultado
`/` ou `/menu` + Enter	Paleta raiz: todos os comandos agrupados por categoria
Um comando “pickável” bare (ex.: `/model`, `/config`, `/provider`, `/switch`) + Enter	Paleta 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:

Tecla	Ação
`↑` / `↓` (ou `Ctrl+P` / `Ctrl+N`)	Mover a seleção
Digitar	Filtrar (fuzzy)
`→` / `Enter`	Entrar no subnível ou selecionar (executa o comando)
`Tab`	Inserir a seleção como texto
`←` / `Esc` / `Backspace`	Voltar um nível (ou cancelar na raiz)
`Ctrl+C`	Cancelar

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, com a experiência ChatCLI completa: chat pelo pipeline inteiro (ask_chatcli — memória, contextos, skills, knowledge), os loops agent/coder reais (agent_task, coder_task), gestão de sessões (manage_session), todas as built-in tools, skills como prompts, estado local como resources chatcli:// e continuidade via hub de conversas. 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): modos de sessão chat/agent/coder, updates estruturados de tool call e plano, slash commands do prompt da IDE, dialogs nativos de permissão e restauração via session/load (estado vivo ou o espelho de autosave, com replay da conversa), para IDEs JetBrains, Zed e qualquer cliente ACP. Ver ACP — ChatCLI dentro da sua IDE.

`/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.

Subcomando	Descrição
`/config security`	Dump read-only (comportamento anterior)
`/config security rules`	Lista 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 reload`	Forç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 ).

Subcomando	Argumento	Descrição
`/channel` ou `/channel list`	—	Lista 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 channel	Filtra a listagem pelas mensagens daquele channel
`/channel ack`	—	Marca todas as mensagens como lidas, limpa o banner de notify pendentes. Retorna quantas entradas foram limpas
`/channel inject`	—	Injeta 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 pause`	—	Pausa o trigger engine. Mensagens continuam entrando no ring/persistência, mas nenhuma `Action` é emitida (zero banners, confirms, autos) enquanto pausado
`/channel resume`	—	Reativa o trigger engine
`/channel rules`	—	Lista rules ativas com nome, modo, filtros (`server`/`channel`/`contentRegex`) e configs (`rate`, `dedup`, `tools`)
`/channel rules reload`	—	Re-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ório	Aceita uma `Action` confirm pendente (default = yes); roda o agent no template da rule dentro de uma `AUTO-AGENT envelope box`
`/channel confirm <id> no`	id obrigatório	Recusa uma `Action` confirm pendente sem disparar nada
`/channel run <seq>`	seq obrigatório	Dispara 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ão	Slash	Default	O que faz
#1 ReAct	—	sempre on	Loop base
#2 Plan-and-Solve	`/plan`	auto (complexity ≥ 6)	Plano JSON + ReWOO
#3 Reflexion	`/reflect`	on (em erros)	Lições persistidas
#4 RAG + HyDE	—	off	Retrieval semântico
#5 Self-Refine	`/refine on`	off	Critique + rewrite
#6 CoVe	`/verify on`	off	Chain-of-Verification
#7 Reasoning	`/thinking on`	auto (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:

Subcomando	O que faz
`/reflect`	Status: queue depth + DLQ size + hint dos subcomandos
`/reflect <texto livre>`	Persiste lição manual em `memory.Fact` (sem LLM)
`/reflect list`	Lista pendentes + DLQ com trigger, attempts, age, task preview
`/reflect failed`	Só 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 drain`	Forç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.

Comando	Descrição
`/config`	Panorama 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 all`	Dump completo — todas as seções em sequência
`/config general`	`.env` path, locale, logging, version check, history file
`/config update`	Política de auto-update (`CHATCLI_AUTO_UPDATE`), canal de instalação detectado, versão atual vs. última release
`/config providers`	Env 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 agent`	Runtime do modo agente: coder UI, workers, subagents, timeouts, tmpdir, denial caps, per-agent overrides, persona ativa
`/config resilience`	Payload caps, recovery ladder, stream timeout, confiança TLS global (CA bundle, skip-verify), proxy Bedrock (CA bundle, IMDS), compactação
`/config session`	Sessão atual (nome, mensagens, custo, budget), contextos anexados, sistema de memória
`/config memory`	Modo de injeção de memória, gates de auto-recall, configurações do grafo de conhecimento e stats ao vivo de nós/arestas
`/config selfevolve`	Auto-evolução de skills: modo (`CHATCLI_SELFEVOLVE_MODE` `auto`/`suggest`/`off`) + observabilidade (skills criadas pelo engine vs. total). Ver Auto-autoria de Skills
`/config commands`	Catálogo de slash commands: cada template carregado com sua origem, nomes recusados por shadow de built-ins, diretórios varridos; `reload` força re-scan. Ver Slash Commands
`/config integrations`	MCP (servers + tool count), hooks, plugins, skill registries, websearch (cadeia ativa), worktrees (se em repo git), watcher K8s, conexão remota
`/config auth`	Status OAuth por provider (`anthropic`, `openai-codex`, `github-copilot`, `github-models`) com expiração do token, keychain backend
`/config security`	Política de comandos (allow/denylist, sudo), sandbox de workspace, política do Coder, TLS/proxy, redação
`/config quality`	Pipeline dos sete padrões: Self-Refine, CoVe, Reflexion, Plan-First, HyDE (vetores + provider + contagem), Reasoning backbone — ver overview completo
`/config compression`	Compressão de Contexto (CCR): modo, threshold, store CCR, economia. Mutável — `off`/`lossless`/`lossy`/`stats`
`/config output`	Redução de tokens de saída: verbosity steering + effort routing. Mutável — `full`/`concise`/`minimal`, `effort on\|off`
`/config server`	Condicional — só renderiza se alguma env de server mode estiver setada (gRPC, JWT, rate limit, fallback chain, watcher, audit, operator)
`/config hub`	Conversation 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):

Comando	Efeito
`/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

Comando	Descrição
`/websearch` ou `/websearch status`	Mostra provider atual + cadeia de fallback ativa
`/websearch list`	Lista 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 reset`	Remove 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`)

Comando	Descrição
`/switch`	Bare abre a paleta de provedores/flags; também aceita as flags abaixo
`/switch --model <nome>`	Troca o modelo do provedor ativo
`/switch --model`	Lista 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
`/providers`	Alias 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 (`@`)

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

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.

Plugin	Subcomandos	Doc
`@coder`	`read`, `write`, `patch`, `multipatch`, `tree`, `search`, `exec`, `test`, `rollback`, `git-status`, `git-diff`, `git-log`, `git-changed`, `git-branch`, `clean`	Plugin @coder
`@read`	(flat) `file`, `from_line`, `to_line`, `head`, `tail`, `encoding`	Tools Atômicos
`@search`	(flat) `term`, `dir`, `max_results`, `include`	Tools Atômicos
`@tree`	(flat) `dir`, `depth`, `exclude`	Tools Atômicos
`@todo`	`write`, `list`, `mark`	Tools Atômicos
`@websearch`	`search`	Web Tools
`@webfetch`	`fetch`	Web Tools
`@scheduler`	`schedule`, `wait`, `query`, `list`, `cancel`	Scheduler
`@agents`	`list`, `show`, `cancel`	Agent Squad
`@board`	`create`, `list`, `show`, `move`, `assign`, `note`, `link`, `archive`	Agent Squad
`@mail`	`send`, `inbox`, `history`	Agent Squad
`@park`	`delay`, `until`, `for_url`, `for_cmd`, `list`, `note`	Agent Park
`@memory`	`remember`, `recall`, `forget`, `profile`, `timeline` (episódios datados), `neighbors`, `map` (grafo de conhecimento)	Bootstrap e Memória
`@skill`	`create`, `update`, `list`, `show`, `remove`, `restore`, `stats`, `export`, `import`	Auto-autoria de Skills
`@commands`	`list`, `get` — o modelo descobre e expande templates de slash commands	Slash Commands
`@knowledge`	`search`, `get`, `toc`	Knowledge Base
`@model`	`list`, `use`, `reset`, `status`, `delegate`	Roteamento de Modelo

Lista parcial — o catálogo completo (32 tools nativas) é auto-gerado: rode /plugin list no ChatCLI, ou peça @tools list a um agente. Destaques comentados em Plugins Agênticos.

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 (também vincula — dali em diante os turnos são gravados via write-through)
`/session load <nome>`	Carrega uma conversa salva (também vincula, e rotaciona a thread compartilhada do hub)
`/session attach <nome>`	Vincula a uma sessão nomeada — carrega se existir, cria se não; cada turno sincroniza nas duas direções com as outras superfícies (veja Continuidade cross-surface)
`/session detach`	Mantém a conversa, remove o vínculo — os turnos param de ser gravados
`/session status`	Mostra se (e a qual sessão) a conversa está vinculada
`/session list`	Lista todas as sessões
`/session delete <nome>`	Deleta uma sessão
`/session new`	Inicia sessão limpa (desvincula e rotaciona a thread compartilhada do hub, como `/newsession`)
`/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`)

Comando	Descrição
`/context create <nome> ...`	Cria snapshot de arquivos/diretórios (`--mode knowledge` indexa corpora de docs ou de código/infra como knowledge base)
`/context update <nome> ...`	Atualiza contexto existente
`/context attach <nome>`	Anexa contexto à sessão atual (`--rag [K]` retrieval semântico, `--full`/`-f` conteúdo inteiro, `--chunk(s)`, `--priority`; contextos grandes auto-promovem para RAG com embeddings ativos)
`/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> [--from <reg>]`	Instala skill de um registry (específico ou auto-detect)
`/skill uninstall <name>`	Remove skill instalada (disambigua se múltiplas sources)
`/skill list`	Lista skills instaladas com source e versão
`/skill info <name> [--from <reg>]`	Metadados completos (installs, security audits)
`/skill registries`	Mostra 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> --reset`	Remove 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 pinned`	Lista as skills fixadas na sessão atual
`/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 o card de versão (mesma saída do `/version`)
`-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`

Memória

Comando	Descrição
`/memory` ou `/memory today`	Mostra as notas de hoje
`/memory yesterday`	Mostra as notas de ontem
`/memory <data>`	Mostra notas de uma data (YYYY-MM-DD, YYYYMMDD, DD/MM/YYYY)
`/memory week`	Notas dos últimos 7 dias
`/memory longterm`	Conteúdo do MEMORY.md (fatos de longo prazo)
`/memory list`	Lista todos os arquivos de memória (inclui JSONs estruturados)
`/memory load <data>`	Carrega notas no contexto da conversa
`/memory profile`	Perfil do usuário (nome, função, empresa, localização, skills, certificações, objetivos, interesses, diretivas, posições, marcos, ambiente; 🔒 marca campos sensíveis)
`/memory profile set <campo>=<valor>`	Define/atualiza um campo do perfil. Listas fazem upsert (reafirmar supera o antigo); sufixos reescrevem: `goals_replace=` substitui tudo, `goals_done=`/`goals_remove=` removem. Chaves novas: `stance=posição :: razão`, `milestone=`, `env_<chave>=`, `directives=[scope:<projeto>] regra`, `sensitive_mark=`
`/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 topics`	Tópicos recorrentes rastreados
`/memory projects`	Projetos rastreados com status
`/memory stats`	Estatísticas de uso (sessões, horas de pico, erros, features)
`/memory facts [categoria]`	Fatos com scores (filtro: architecture, pattern, preference, gotcha, project, personal)
`/memory timeline [q]`	Histórico datado de episódios; `q` filtra por tempo (“3 meses atrás”, “abril”, “2026-04”) e/ou conteúdo
`/memory compact`	Força compactação de memória (LLM + limpeza de notas antigas)

Compactação e Rewind

Comando	Descrição
`/compact`	Compactação automática (pipeline de 3 níveis)
`/compact <instrução>`	Compactação guiada — preserva informações específicas
`/rewind`	Exibe menu de checkpoints para restaurar
Esc+Esc	Atalho 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

Navegação
Edição
Paste

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)
`/` ou `/menu` + Enter	Abrir a paleta de comandos (setas para navegar)

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.

​Comandos Internos (/)

​Paleta de Comandos Interativa

​Subcomando externo chatcli daemon

​Subcomandos externos chatcli mcp-server e chatcli acp

​/config security — rules mutáveis

​/channel — MCP channels inbox e triggers

​Harness/Pipeline de Qualidade — Atalhos

​/reflect — subcomandos

​/config — Panorama e Seções

​/config hub — settings mutáveis

​/websearch — Provider de Busca Web

​Troca de Provedor e Modelo (/switch)

​Comandos de Contexto (@)

​Plugins LLM-callable (@<tool>)

​Modo Agente — Ações

​Sessões (/session)

​Contextos Persistentes (/context)

​Skills (/skill)

​Flags de Linha de Comando (One-Shot)

​Subcomandos

​Memória

​Compactação e Rewind

​Atalhos de Teclado

Comandos Internos (`/`)

Paleta de Comandos Interativa

Subcomando externo `chatcli daemon`

Subcomandos externos `chatcli mcp-server` e `chatcli acp`

`/config security` — rules mutáveis

`/channel` — MCP channels inbox e triggers

Harness/Pipeline de Qualidade — Atalhos

`/reflect` — subcomandos

`/config` — Panorama e Seções

`/config hub` — settings mutáveis

`/websearch` — Provider de Busca Web

Troca de Provedor e Modelo (`/switch`)

Comandos de Contexto (`@`)

Plugins LLM-callable (`@<tool>`)

Modo Agente — Ações

Sessões (`/session`)

Contextos Persistentes (`/context`)

Skills (`/skill`)

Flags de Linha de Comando (One-Shot)

Subcomandos

Memória

Compactação e Rewind

Atalhos de Teclado