Quick Start

→ For a complete first-run walkthrough, see Getting Started.

The 15-minute guide covers:

• Installation (bunx opencode-swarm install)
• First-run auto-configuration (architect selected automatically)
• Running your first task
• Troubleshooting common issues

The installer automatically:

• Creates a project config at .opencode/opencode-swarm.json when missing so project-level overrides have a place to live
• Adds opencode-swarm to the OpenCode plugin list
• Disables the native explore and general agents to reduce routing conflicts

1. Install the plugin (5s)

bunx opencode-swarm install

4. Kick off a task — the architect plans, then gates fire automatically (15s)

Build me a JWT auth helper with tests.

Plan Cursor (v6.13)

The plan_cursor config compresses the plan that is injected into the LLM context.

{
  "plan_cursor": {
    "enabled": true,
    "max_tokens": 1500,
    "lookahead_tasks": 2
  }
}

• enabled – When true (default) Swarm injects a compact plan cursor instead of the full plan.md.
• max_tokens – Upper bound on the number of tokens emitted for the cursor (default 1500). The cursor contains the current phase summary, the full current task, and up to lookahead_tasks upcoming tasks. Earlier phases are reduced to one‑line summaries.
• lookahead_tasks – Number of future tasks to include in full detail (default 2). Set to 0 to show only the current task.

Disabling ("enabled": false) falls back to the pre‑v6.13 behavior of injecting the entire plan text.

License

MIT

Stop hoping your agents figure it out. Start shipping code that actually works.