Skip to main content
A partir da release pós-#920, o ChatCLI ganhou um conjunto de tools atômicos modelados na arquitetura narrow do Claude Code: cada operação read-only mais comum tem seu próprio plugin com schema dedicado em vez de viver dentro do envelope @coder.
Os atômicos coexistem com o @coder — @coder read/search/tree continuam funcionando. A diferença é que o LLM agora pode escolher o tool narrow (mais preciso) quando quiser executar uma única operação read-only.

​
Os quatro tools

​
@read — leitura de arquivo

Equivalente ao Read do Claude Code. Schema flat:
Aliases aceitos: path, filepath. Faixa de linhas, head/tail e encoding base64 suportados. Cap de output: 80 000 chars (versus 30k global) — arquivos grandes (~1500 linhas) cabem inteiros.

​
@search — busca por regex

Equivalente ao Grep do Claude Code. Schema flat:
Aliases: pattern, query, regex. Glob de inclusão, limite configurável de resultados. Cap: 60 000 chars.

​
@tree — árvore de diretórios

Schema flat (todos opcionais — {} lista o cwd):
Profundidade limitada [1,20]. Cap: 50 000 chars.

​
@todo — gestão de plano de tarefas

Paridade com TodoWrite do Claude Code. Três subcomandos:
Status: pending | in_progress | completed | failed. O @todo adapter encaminha pra cli/agent/task_tracker.go ativo do AgentMode atual.

​
Por que narrow tools importam

​
Multipatch transacional

Novidade no @coder:
Phase 1 valida TODAS as edições antes de qualquer escrita. Phase 2 grava — qualquer falha restaura todos os arquivos tocados. Per-file mutex serializa transações concorrentes na mesma file. Use quando uma refatoração precisa ser all-or-nothing.

​
Validação por JSON Schema

Cada plugin atômico ship um JSON Schema draft-2020-12. O agent loop valida os args do LLM antes de chamar Execute. Falhas geram ToolResult{IsError:true, ErrorCode:"InvalidArgs"} com path do campo inválido — o modelo recebe feedback claro em vez de um panic/empty. Plugins legados sem JSONSchemaAware bypassam validação (mudança puramente aditiva).

​
Capability-aware permission gate

O policy_manager agora consulta o capability resolver antes de cair no default ActionAsk:
  1. Deny rules (estrito)
  2. Safety-immune (sempre asks)
  3. Allow/Ask explícito (longest pattern wins)
  4. Read-only exec heuristic
  5. NOVO: capability gate — auto-allow para plugin com IsReadOnly=true
  6. Default: Ask
Resultado: @read, @search, @tree, @websearch, @webfetch (GET), @scheduler query/list rodam sem prompt enquanto write/exec continuam gated.