Kimi CLI AgentSwarm · Curso Visual

AgentSwarm não é `kimi swarm`

Ao final você saberá que swarm é um modo TUI + tool built-in — não um subcomando CLI — e quais pontos de entrada realmente o iniciam.

Leia a versão simples ou abra a camada técnica em qualquer seção.

A ideia central

AgentSwarm é o primitivo de paralelismo estruturado do Kimi Code CLI. O agente principal distribui trabalho para até 128 subagentes, cada um com contexto isolado, e agrega os resultados em XML <agent_swarm_result>. Subagentes não falam com o usuário e não aninham swarms.

A surpresa da engenharia reversa em kimi 0.18.0: não existe subcomando kimi swarm. Swarm é a combinação de três peças:

Swarm Mode — estado TUI via /swarm on, /swarm off ou /swarm <prompt>
Tool built-in — AgentSwarm, disponível ao agente principal
Runtime local — classe SubagentBatch no binário: lança subagentes com rampa controlada, aguarda todos, agrega resultados

Não confunda com Kimi K2.5 Agent Swarm (capacidade de produto/blog com 100–300 subagentes e PARL). A tool do CLI é um executor local e verificável — mesma filosofia, API diferente.

Pense assim… um gerente de projeto que contrata freelancers temporários. Você não roda um app kimi swarm separado — ativa o "modo swarm" com /swarm e o gerente emite uma ordem AgentSwarm listando o escopo de cada contratado. Eles trabalham em salas separadas (agents/agent-N/), reportam de volta, e o gerente sintetiza. É orquestrador → fan-out → fan-in, não uma malha peer-to-peer.

Por baixo do capô

Subcomandos reais em v0.18.0: export, provider, acp, server, web, login, doctor, vis, migrate, upgrade — sem swarm.

Em /swarm on, o runtime registra swarm_mode.enter e injeta enter-reminder.md ("## Swarm Mode") no contexto. O main pode explorar brevemente, depois deve chamar AgentSwarm sozinho em um turno de tools.

Conceito	O que é
Kimi CLI `AgentSwarm`	Tool local: `prompt_template` + `items[]`, máx. 128 subagentes, `agents/<id>/wire.jsonl`
Kimi K2.5 Agent Swarm (produto)	Capacidade de modelo/blog: 100–300 subagentes, PARL, 1500+ tool calls — não é a mesma API

Em uma imagem

Esquerda → direita: /swarm ativa Swarm Mode; main chama AgentSwarm; SubagentBatch distribui e agrega. Caixa tracejada = o que não existe.

No código

Três entradas reais — slash commands. Uma tool built-in. Um comando que as pessoas esperam mas não existe.

kimi --help (v0.18.0)

# Slash commands TUI (Swarm Mode)
/swarm on              # ativa Swarm Mode
/swarm off             # sai do modo
/swarm <prompt>        # ativa + envia tarefa

# Estes NÃO existem:
kimi swarm             # ✗ sem subcomando
kimi agent-swarm       # ✗ sem subcomando

wire.jsonl — swarm_mode.enter (sessão 30e21381)

{
  "type": "swarm_mode.enter",
  "trigger": "manual",
  "time": 1781645840546
}

Checagens reproduzíveis

kimi --version
kimi --help   # confirme ausência de subcomando swarm
strings -a ~/.kimi-code/bin/kimi | rg 'AgentSwarm|SubagentBatch|agent-swarm-exclusive'
rg 'swarm_mode.enter' ~/.kimi-code/sessions/*/session_*/main/wire.jsonl

Experimente: escolha um ponto de entrada

Clique em cada botão. Veja o que o CLI faria — e quais caminhos são becos sem saída.

Dúvidas são bem-vindas — traga seu próprio kimi --help se a versão diferir. Próximo: o schema AgentSwarm e a policy exclusive-deny que governam cada chamada de swarm.