OpenCode Swarm (v6.81.0) is an architect-centric agentic swarm plugin for OpenCode that orchestrates 11 specialized agents for planning, code generation, review, testing, and documentation. This documentation covers installation, configuration, usage, and architecture.
I am a new user — I want to get Swarm running on my first project
→ Start with Getting Started — a 15-minute first-run walkthrough
I am an operator — I want to install Swarm in CI/container or a specific environment
→ Choose your platform:
- Installation Guide — comprehensive reference for all platforms
- Installation: Linux + Docker — native Linux, Windows, Docker Desktop specifics
- Installation: LLM Operator — machine-executable runbook for LLM-driven setup
I am a contributor — I want to understand the architecture or contribute to the project
→ Read Architecture Deep Dive and Design Rationale, then CONTRIBUTING.md
| Document | Covers |
|---|---|
| Configuration Reference | Config file locations, minimal example, all configuration keys |
| Commands Reference | All 41 /swarm subcommands, flags, and examples |
| Modes: Swarm vs Turbo vs Full-Auto | Execution modes, safety gates, when to use each |
| Pre-Swarm Planning Guide | How to plan tasks before running, task field reference, multi-model planning, spec pipeline |
| Swarm Briefing for LLMs | Pipeline steps, task format, state machine — written for LLM plan authors |
| PHP and Laravel Practical Guide | Framework detection, Laravel command override, Pest/PHPUnit coexistence, SAST coverage |
| Document | Covers |
|---|---|
| Building a Web App | End-to-end walkthrough: React + auth with brainstorm, autonomous execution, and monitoring |
| Document | Covers |
|---|---|
| Knowledge System | Hive vs swarm knowledge, TTL decay, migration, quarantine workflows |
| Evidence and Telemetry | Evidence bundle schema, JSONL event stream, how to analyze results |
| Work Complete Council | Optional consensus gate for verifying phase completion |
| Troubleshooting | Session recovery, common error scenarios |
| Document | Covers |
|---|---|
| Architecture Deep Dive | Control model, 11 agent roles, full execution pipeline, tools, evidence schema, modes, guardrails |
| Design Rationale | Core design decisions: serial execution, phased planning, persistent memory, gated QA |
| Plan Durability | How .swarm/plan-ledger.jsonl provides crash-safe plan persistence |
Latest version: v6.81.0 (released 2026-04-22)
The full release history is documented in CHANGELOG.md (v6.15.0 through v6.81.0).
Recent highlights:
| Version | Highlights |
|---|---|
| v6.81.0 | Current version — documentation refresh |
| v6.80.2 | Latest stable release with notes |
| v6.80.1 | Patch release |
| v6.78.0 | Stability improvements |
| v6.77.0 | Feature releases and hardening |
| v6.76.0 | Major feature additions |
| v6.74.0 | Quality gate enhancements |
| v6.73.0 | Critic hallucination verifier, phase_complete gate enforcement |
| v6.72.0 | Knowledge N-phase TTL decay, stale-entry sweep |
| v6.71.0 | Scope persistence, interpreter gating, audit logging |
| v6.70.0 | Transparent write authority, symlink guards, universal deny prefixes |
| v6.68.0 | SQLite constraint store, QA gate profiles, BRAINSTORM mode |
| v6.67.0 | Council tools, round-history auditing |
| v6.66.0 | Work Complete Council verification gate |
| v6.65.0 | Workspace dependency graph |
| v6.64.0 | Repo map and code graph |
| v6.63.0 | Crash-safe ledger, typed concurrency errors |
| v6.59.0 | State-of-the-art PR review agent, explorer hardening |
| v6.58.0 | Structured spec format with RFC 2119 keywords |
| v6.45.0 | Structured workspace search, patch suggestions, symbol extraction |
All versions from v6.15.0 onward have release notes in /docs/releases/.
These documents are archived from the v6.9.0 development phase and are retained for historical provenance.
See Archive for:
- v6.9.0 phase planning documents (phase0-*, stages 1–8)
- Historical tech debt reviews and closure plans
- Archived issue-specific planning documents
- CHANGELOG.md — full version-by-version history
- README.md — project overview, feature summary, configuration quick ref
- CONTRIBUTING.md — how to contribute, commit format, PR workflow
- TESTING.md — test framework (bun:test), mock isolation, CI pipeline
- New to Swarm? Start with Getting Started
- Upgrading? Check CHANGELOG.md for breaking changes (rare)
- Reporting issues? See CONTRIBUTING.md for how to file bugs
- Have questions? Check this index or search CHANGELOG.md and architecture.md for your keyword
Last updated: 2026-04-22. Covers opencode-swarm v6.81.0.