> ## Documentation Index > Fetch the complete documentation index at: https://chatcli.edilsonfreitas.com/llms.txt > Use this file to discover all available pages before exploring further. # Referência Completa de Comandos > Cheatsheet para todos os comandos, flags e opções disponíveis no ChatCLI. 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](#paleta-de-comandos-interativa)) | | `/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` | Recarregar configurações do `.env` — inclui o provider de embeddings (`CHATCLI_EMBED_*`): trocar para `bedrock`/`voyage`/`openai` passa a valer 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 ` | Atalho para `/switch --model `; bare abre a paleta com os modelos disponíveis | | `/max-tokens ` | Atalho para `/switch --max-tokens `; 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 | | `/session` | Gerenciar sessões (`save`, `load`, `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` | Verificar versão | | `/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 =`, `remember `, `forget `, topics, projects, stats, facts, compact) | | `/graph` | Renderiza o grafo de conhecimento em imagem (PNG, via go-graphviz embarcado). `/graph` = grafo completo; `/graph ` = 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](#channel-mcp-channels-inbox-e-triggers) | | `/websearch` | Gerenciar provider de busca web (`status`, `list`, `provider`, `reset`) | | `/thinking` | Override cross-provider de reasoning/thinking (`on\|off\|auto\|low\|medium\|high\|max\|budget=N`) — ver [#7 Reasoning Backbone](/pt/features/quality/reasoning-backbone) | | `/plan` | Força Plan-and-Solve / ReWOO no próximo `/agent` ou `/coder` — ver [#2 Plan-and-Solve](/pt/features/quality/plan-and-solve) | | `/refine` | Toggle do Self-Refine na sessão (`on\|off\|once\|auto`) — ver [#5 Self-Refine](/pt/features/quality/self-refine) | | `/verify` | Toggle do Chain-of-Verification na sessão (`on\|off\|once\|auto`) — ver [#6 CoVe](/pt/features/quality/cove) | | `/reflect` | Fila durável de lições (status, list, failed, retry, purge, drain) — ver [#3 Reflexion](/pt/features/quality/reflexion) | | `/schedule` | Agenda um job durável (cron / relative / interval / wait-until) — ver [Scheduler](/pt/features/scheduler) | | `/wait` | Aguarda uma condição e opcionalmente dispara ação — ver [Scheduler](/pt/features/scheduler) | | `/jobs` | Gerencia jobs agendados (`list`, `show`, `tree`, `cancel`, `pause`, `resume`, `logs`, `history`, `daemon`, `gc`) | | `/parked` | Lista agents estacionados via `@park` — `prune` limpa terminais, `gc ` limpa antigos — ver [Agent Park & Resume](/pt/features/agent-park) | | `/resume` | `/resume ` força retomada imediata de um park (idempotente contra auto-resume) | | `/cancel-park` | `/cancel-park ` aborta um park: deleta snapshot + cancela job no scheduler | | `/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](/pt/features/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](/pt/features/chat-gateway) | | `/hub` | Inspeciona e gerencia a conversa compartilhada cross-channel: `whoami` (principal + conversa ativa), `bind [principal]`, `bindings [principal]` — ver [Conversation Hub](/pt/features/conversation-hub) | | `/lsp ` | Diagnósticos de código (erros/avisos) de um arquivo via Language Server Protocol — ver [Diagnósticos LSP](/pt/features/lsp-diagnostics) | ## 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 `` 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`](/pt/features/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 ]` — controla o scheduler daemon em background. Qualquer CLI interativo detecta o daemon e vira thin client via UNIX socket. Veja [Scheduler → Daemon mode](/pt/features/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)](/pt/features/mcp-server). `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. | 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 "" [--yes]` | Adiciona rule ALLOW; confirma se o pattern é amplo | | `/config security deny "" [--yes]` | Adiciona rule DENY; confirma `[y/N]` | | `/config security forget "" [--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 ` ` como o PolicyManager normaliza (`@coder exec `). Deny sempre bate allow. ### `/channel` — MCP channels inbox e triggers Gerencia o inbox de [MCP Channels](/pt/features/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 ` | 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 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 no` | id obrigatório | Recusa uma `Action` confirm pendente sem disparar nada | | `/channel run ` | 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](/pt/reference/mcp-config#trigger-rules-chatcli-mcp-triggers-json). *** ## 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](/pt/features/quality/overview) · [Configuração](/pt/features/quality/configuration) ### `/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 ` | 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 ` | Reenfileira job da DLQ (reseta Attempts=0) — Tab autocompleta IDs vivos | | `/reflect purge ` | 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 ` 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 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 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](/pt/features/skill-authoring) | | `/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](/pt/features/quality/overview) | | `/config compression` | [Compressão de Contexto (CCR)](/pt/features/context-compression): 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
` 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 ` | Liga/desliga o hub | | `/config hub set principal ` | Define a identidade compartilhada da conversa | | `/config hub set isolate ` | Isola cada canal (bot multi-usuário) vs. colapsar no principal | | `/config hub set ttl_hours ` | Horas até podar conversa ociosa (`0` desativa) | | `/config hub reset ` | 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 ` | 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](/pt/features/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 ` | Troca o modelo do provedor ativo | | `/switch --model` | Lista todos os modelos disponíveis (dinâmico da API) | | `/switch --max-tokens ` | Define máximo de tokens para respostas | | `/switch --realm ` | Altera realm/tenant (apenas StackSpot) | | `/switch --agent-id ` | Altera agent (apenas StackSpot) | | `/provider ` | Troca o provedor ativo pelo nome (case-insensitive); bare abre a **paleta** com os provedores ativos | | `/providers` | Alias de `/provider` | | `/model ` | **Atalho** de `/switch --model ` (bare abre a paleta com os modelos) | | `/max-tokens ` | **Atalho** de `/switch --max-tokens ` (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. ```bash theme={"system"} # 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 (`` após `/`) e têm autocomplete próprio — `/model ` sugere os modelos do provedor ativo, `/provider ` lista os provedores e `/max-tokens ` oferece presets (`0`, `1024`, `4096`, `8192`, `16384`, `32768`). *** ## Comandos de Contexto (`@`) | Comando | Descrição | | --------------------- | --------------------------------------------------- | | `@file ` | Anexa conteúdo de arquivo ou estrutura de diretório | | `@file --mode ` | Modo: `full`, `summary`, `chunked`, `smart` | | `@command ` | 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 (`@`) Tools que o agente pode invocar via `` (modos `/agent`, `/coder`). Catálogo completo em [Plugin System](/pt/features/plugin-system) e [Tools Atômicos](/pt/features/atomic-tools). | 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](/pt/features/coder-plugin) | | `@read` | (flat) `file`, `from_line`, `to_line`, `head`, `tail`, `encoding` | [Tools Atômicos](/pt/features/atomic-tools) | | `@search` | (flat) `term`, `dir`, `max_results`, `include` | [Tools Atômicos](/pt/features/atomic-tools) | | `@tree` | (flat) `dir`, `depth`, `exclude` | [Tools Atômicos](/pt/features/atomic-tools) | | `@todo` | `write`, `list`, `mark` | [Tools Atômicos](/pt/features/atomic-tools) | | `@websearch` | `search` | [Web Tools](/pt/features/web-tools) | | `@webfetch` | `fetch` | [Web Tools](/pt/features/web-tools) | | `@scheduler` | `schedule`, `wait`, `query`, `list`, `cancel` | [Scheduler](/pt/features/scheduler) | | `@park` | `delay`, `until`, `for_url`, `for_cmd` | [Agent Park](/pt/features/agent-park) | | `@memory` | `remember`, `recall`, `forget`, `profile`, `neighbors`, `map` (grafo de conhecimento) | [Bootstrap e Memória](/pt/features/bootstrap-memory) | | `@skill` | `create`, `update`, `list`, `show`, `remove`, `restore`, `stats`, `export`, `import` | [Auto-autoria de Skills](/pt/features/skill-authoring) | | `@knowledge` | `search`, `get`, `toc` | [Knowledge Base](/pt/features/knowledge-base) | > 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](/pt/features/agentic-plugins). *** ## 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 ` | Salva a conversa atual | | `/session load ` | Carrega uma conversa salva | | `/session list` | Lista todas as sessões | | `/session delete ` | Deleta uma sessão | | `/session new` | Inicia sessão limpa | | `/session fork ` | Cria fork independente da sessão atual | | `/session search ` | 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 ...` | Cria snapshot de arquivos/diretórios (`--mode knowledge` indexa corpora de docs **ou de código/infra** como [knowledge base](/pt/features/knowledge-base)) | | `/context update ...` | Atualiza contexto existente | | `/context attach ` | Anexa contexto à sessão atual | | `/context detach ` | Desanexa contexto | | `/context list` | Lista contextos salvos | | `/context show ` | Mostra detalhes e arquivos | | `/context inspect ` | Estatísticas detalhadas | | `/context delete ` | Deleta permanentemente | | `/context merge ` | Combina contextos | | `/context attached` | Mostra contextos anexados com estimativa de tokens e dicas de cache | | `/context export ` | Exporta para JSON | | `/context import ` | Importa de JSON | | `/context metrics` | Estatísticas de uso | *** ## Skills (`/skill`) | Comando | Descrição | | -------------------------------------- | -------------------------------------------------------------------- | | `/skill search ` | Busca em todos os registries (fan-out paralelo) | | `/skill install [--from ]` | Instala skill de um registry (específico ou auto-detect) | | `/skill uninstall ` | Remove skill instalada (disambigua se múltiplas sources) | | `/skill list` | Lista skills instaladas com source e versão | | `/skill info [--from ]` | Metadados completos (installs, security audits) | | `/skill registries` | Mostra registries configurados e status | | `/skill registry enable ` | Ativa um registry (hot-reload imediato) | | `/skill registry disable ` | Desativa um registry (hot-reload imediato) | | `/skill prefer [name] [source]` | Define/mostra preferência de source para skills com conflito | | `/skill prefer --reset` | Remove preferência (volta ao padrão: local ganha) | | `/skill pin ` | Fixa uma skill na sessão — injetada em todo turno até `/skill unpin` | | `/skill unpin ` | 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 ` | Sobrescreve provedor (ex: `CLAUDEAI`) | | `--model ` | Sobrescreve modelo | | `--timeout ` | Tempo limite (ex: `10s`, `1m`) | | `--max-tokens ` | 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 Inicia como servidor gRPC para acesso remoto. | Flag | Descrição | Padrão | | --------------------------- | -------------------------- | ----------- | | `--port ` | Porta gRPC | `50051` | | `--token ` | Token de autenticação | `""` | | `--tls-cert ` | Certificado TLS | `""` | | `--tls-key ` | Chave TLS | `""` | | `--provider ` | Provedor LLM padrão | Auto | | `--model ` | Modelo padrão | Auto | | `--watch-deployment ` | Deployment K8s a monitorar | `""` | | `--watch-namespace ` | Namespace | `"default"` | | `--watch-interval ` | Intervalo de coleta | `30s` | | `--watch-window ` | Janela de observação | `2h` | | `--watch-max-log-lines ` | Max linhas de log/pod | `100` | | `--watch-kubeconfig ` | Kubeconfig | Auto | Conecta a um servidor remoto via gRPC. | Flag | Descrição | Padrão | | -------------------- | ----------------------------- | ------- | | `
` | Endereço (posicional) | | | `--addr ` | Endereço (flag) | `""` | | `--token ` | Token de autenticação | `""` | | `--provider ` | Sobrescreve provedor | `""` | | `--model ` | Sobrescreve modelo | `""` | | `--llm-key ` | Sua API key | `""` | | `--use-local-auth` | Usa OAuth do auth store local | `false` | | `--tls` | Habilita TLS | `false` | | `--ca-cert ` | Certificado CA | `""` | | `-p ` | One-shot remoto | `""` | | `--raw` | Saída sem formatação | `false` | | `--max-tokens ` | Max tokens | `0` | Monitora deployment K8s com IA. | Flag | Descrição | Padrão | | --------------------- | ------------------------- | ----------- | | `--deployment ` | Deployment (obrigatório) | `""` | | `--namespace ` | Namespace | `"default"` | | `--interval ` | Intervalo de coleta | `30s` | | `--window ` | Janela de observação | `2h` | | `--max-log-lines ` | Max linhas de log/pod | `100` | | `--kubeconfig ` | Kubeconfig | Auto | | `--provider ` | Provedor LLM | `.env` | | `--model ` | Modelo LLM | `.env` | | `-p ` | One-shot com contexto K8s | `""` | | `--max-tokens ` | 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 ` | 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 ` | 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 =` | 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_=`, `directives=[scope:] regra`, `sensitive_mark=` | | `/memory remember ` | Adiciona um fato de longo prazo explicitamente (aceita prefixo `[categoria]`) | | `/memory forget ` | 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 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 ` | 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 | 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](#paleta-de-comandos-interativa) (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.