OpenCode Swarm

OpenCode Swarm is an architect-centric multi-agent orchestration plugin that transforms single AI coding sessions into expert-team collaboration via a hub-and-spoke architecture.

Core Capabilities#

Multi-Agent Orchestration: 17+ specialized agent roles (architect, coder, reviewer, test_engineer, critic, etc.) managed in three categories—Core (always available, 9), Optional (enabled by default, 5), Conditional (feature-configured, 3). Architect acts as the central hub coordinating all agents; agents never modify the codebase in parallel.

Gated Pipeline: Each task runs a 5-step pipeline (pre_check_batch → coder implementation → reviewer review → test_engineer testing → architect regression scan). Code commits require dual reviewer + test_engineer approval; phase completion passes through completion-verify and drift-verifier gates. Hallucination verification (critic_hallucination_verifier) validates referenced API authenticity; plan drift detection (critic_drift_verifier) blocks deviations from specifications; placeholder/TODO scanning rejects incomplete stub code.

Security & Quality: Built-in SAST scanning (63+ rules, 9 languages, fully offline), secrets scanning, dependency audit. slop-detector enabled in strict project mode.

Execution & Project Modes: Three execution modes (Balanced/default high-security / Turbo/fast iteration skipping non-critical gates / Full-Auto/unattended with critic_oversight independent approval) and three project modes (strict / balanced / fast). Compatible with OpenCode Zen free model list.

Multi-Language Support: Tree-sitter WASM (web-tree-sitter + @vscode/tree-sitter-wasm) enables syntax parsing and security scanning across 20 languages including TypeScript, Python, Go, Rust, Java, Kotlin, C/C++, C#, Ruby, Swift, Dart, PHP, JavaScript, CSS, Bash, PowerShell, INI, Regex.

State Persistence: All session state stored in .swarm/ directory (plans, evidence, context, knowledge, telemetry) with cross-session recovery support.

Architecture & Implementation#

Built with TypeScript + Bun runtime (>=1.3.13), Zod (^4.1.8) for runtime type validation, Biome (v2.3.14) for code quality. Integrates via @opencode-ai/plugin (^1.1.53) and @opencode-ai/sdk (^1.1.53). CLI entry at dist/cli/index.js, Bun build outputs ESM with tsc type declarations.

Installation & Usage#

Prerequisites: Bun runtime and OpenCode.

bunx opencode-swarm install

This installs the package, registers it as an OpenCode plugin, disables conflicting default agents, and creates the config file. Alternative: npm install -g opencode-swarm && opencode-swarm install.

41 slash commands available, key ones: /swarm status, /swarm plan [N], /swarm agents, /swarm evidence [task], /swarm diagnose, /swarm turbo [on|off], /swarm full-auto [on|off].

Config files at global ~/.config/opencode/opencode-swarm.json or project-level .opencode/opencode-swarm.json, supporting agent model overrides, agent disabling, gate adjustments, etc.

Unconfirmed Items#

• Documentation site (https://opencode-swarm.dev) reachability not verified
• Relationship with opencode-ai/opencode (official vs community plugin) unclear
• Author zaxbysauce background undisclosed
• v7.7.0 (1,388 commits) upgrade path and compatibility strategy requires CHANGELOG review