Opencode Swarm
Architect-centric agentic swarm plugin for OpenCode. Hub-and-spoke orchestration with SME consultation, code generation, and QA review.
What is Opencode Swarm?
Opencode Swarm is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to architect-centric agentic swarm plugin for opencode. hub-and-spoke orchestration with sme consultation, code generation, and qa review.
Architect-centric agentic swarm plugin for OpenCode. Hub-and-spoke orchestration with SME consultation, code generation, and QA review.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Architect-centric agentic swarm plugin for OpenCode. Hub-and
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx opencode-swarmConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Opencode Swarm
Opencode Swarm is an architect-centric agentic swarm plugin for OpenCode that implements hub-and-spoke orchestration with specialized agents for planning, coding, SME consultation, code review, and QA testing. It installs as an OpenCode plugin and adds a /swarm command suite along with local quality gates including Tree-sitter syntax validation, 63+ offline SAST security rules, placeholder detection, and mutation testing — all without requiring Docker or cloud infrastructure. The system supports multiple LLM providers through OpenCode's unified provider system, including a free tier.
Prerequisites
- Bun runtime installed (recommended) or Node.js with npm
- OpenCode installed and configured
- A supported LLM provider configured in OpenCode (free tier available via OpenCode Zen)
- Git installed for code introspection tools
Install Opencode Swarm
Run the installer using Bun (preferred) or npm. The installer automatically creates the project config, registers the plugin, and generates a ready-to-edit global config file.
bunx opencode-swarm installOpen OpenCode to verify setup
Start OpenCode — it will auto-select the Swarm architect on first run. Verify the plugin is active by running the agents check command.
opencode
# Inside the session:
/swarm agentsReview and edit your config
The installer generates a global config at ~/.config/opencode/opencode-swarm.json. Edit it to assign specific models to each agent role and set your preferred execution mode.
{
"agents": {
"coder": {
"model": "anthropic/claude-sonnet-4-20250514",
"fallback_models": ["opencode/minimax-m2.5-free"]
},
"reviewer": { "model": "google/gemini-2.5-flash" }
},
"execution_mode": "balanced"
}Create a project-level config override
Create a .opencode/opencode-swarm.json in your project root to override global settings for this specific project. Project config takes precedence over global config.
mkdir -p .opencode
# Create .opencode/opencode-swarm.json with project-specific overridesRun a task through the swarm
Describe your coding task in natural language. The swarm will plan, assign agents, run quality gates, and produce reviewed, tested code. Monitor progress with /swarm status.
# Inside an opencode session:
Build me a JWT authentication middleware for Express.js
/swarm status
/swarm evidenceOpencode Swarm Examples
Client configuration
Opencode Swarm is a plugin that runs inside OpenCode, not a standalone MCP server. Configuration lives at ~/.config/opencode/opencode-swarm.json. This is an example model configuration.
{
"agents": {
"coder": {
"model": "anthropic/claude-sonnet-4-20250514",
"fallback_models": ["opencode/big-pickle"]
},
"reviewer": { "model": "zai-coding-plan/glm-5" }
},
"execution_mode": "balanced",
"gates": {
"syntax": true,
"sast": true,
"placeholder": true
}
}Prompts to try
Example tasks and /swarm commands to use within an OpenCode session after the plugin is installed.
- "Build me a REST API endpoint for user registration with input validation"
- "/swarm show-plan" — view the generated task plan
- "/swarm agents" — check which agents and models are active
- "/swarm evidence" — review quality gate results for the last task
- "/swarm pr subscribe https://github.com/org/repo/pull/42" — monitor a GitHub PR
- "/swarm deep-dive src/" — run a read-only audit of the codebaseTroubleshooting Opencode Swarm
Plugin not found after installation — /swarm commands are unrecognized
Run `bunx opencode-swarm install` again to re-assert the plugin registration. Check that OpenCode is looking for plugins in ~/.cache/opencode/node_modules/ or ~/.config/opencode/node_modules/. Restart OpenCode after reinstalling.
Quality gates fail to run — syntax_check or sast_scan errors
These gates run locally without Docker. Ensure Bun or Node.js is current enough to support the tool's tree-sitter bindings. Run `/swarm diagnose` inside a session to get a health report of which gates are functional.
Agents are using an unexpected model or ignoring config
Project config in .opencode/opencode-swarm.json overrides global config. If you have a project config with incomplete agent entries, missing keys fall through to global defaults. Run `/swarm config` to see the effective merged configuration.
Frequently Asked Questions about Opencode Swarm
What is Opencode Swarm?
Opencode Swarm is a Model Context Protocol (MCP) server that architect-centric agentic swarm plugin for opencode. hub-and-spoke orchestration with sme consultation, code generation, and qa review. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Opencode Swarm?
Follow the installation instructions on the Opencode Swarm GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Opencode Swarm?
Opencode Swarm works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Opencode Swarm free to use?
Yes, Opencode Swarm is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Opencode Swarm Alternatives — Similar Coding Agents Servers
Looking for alternatives to Opencode Swarm? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Opencode Swarm in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Opencode Swarm?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.