OpenCode Swarm is a plugin for the OpenCode AI coding environment that transforms a single AI coding session into an architect-led team of specialized agents. It addresses the common limitation of single-model AI coding by employing a swarm of distinct agents for planning, implementation, review, testing, and documentation, ensuring code quality and functionality through a rigorous, gated pipeline. This is beneficial for engineers and power users seeking more reliable and robust AI-generated code.

How It Works

The core approach utilizes a hub-and-spoke orchestration model with up to 17 specialized agents, including an architect, coder, reviewer, and test engineer. Code development proceeds through a strictly enforced, gated pipeline where each task must pass sequential checks by multiple agents. This phased execution, combined with completion gates and drift verifiers, ensures that code is thoroughly vetted before progressing, preventing parallel code mutations and improving overall quality.

Quick Start & Requirements

• Primary Install: bunx opencode-swarm install (requires Bun). An npm alternative is npm install -g opencode-swarm && opencode-কেopencode-swarm install.
• Prerequisites: Bun runtime.
• Links: Website, Getting Started, Configuration, Architecture.

Highlighted Details

• Features 17 specialized agents (core, optional, conditional) for distinct roles like architect, coder, reviewer, and SME.
• Employs a gated pipeline requiring approval from reviewer and test engineer before code commits.
• Supports resumable sessions, saving all project state to the .swarm/ directory.
• Handles 20 programming languages and includes built-in security scanning (SAST, secrets, dependency audit).
• Offers a free tier utilizing OpenCode Zen's free model roster and is fully configurable.
• Provides flexible session modes (Balanced, Turbo, Full-Auto) and project modes (strict, balanced, fast).

Maintenance & Community

The project includes badges for npm version and tests, indicating ongoing development and quality assurance efforts. Specific details on maintainers, community channels (like Discord/Slack), or sponsorship are not detailed in the provided README.

Licensing & Compatibility

The project is licensed under the MIT license, which is permissive and generally compatible with commercial use and closed-source projects.

Limitations & Caveats

Installation requires the Bun runtime. The project notes potential issues with OpenCode's plugin caching, necessitating specific update commands. The "Turbo" mode bypasses certain QA gates for increased speed, and some advanced configuration fields are noted as not yet enforced at runtime. The save_plan tool strictly requires an explicit working_directory parameter.