Packagesopencode-swarm-plugin
OpenCode Plugin
Multi-agent coordination, task decomposition, and learning systems
OpenCode Plugin
The opencode-swarm-plugin provides 40+ tools for multi-agent coordination, task decomposition, and learning systems. All tools are type-safe with Zod validation.
Installation
npm install -g opencode-swarm-plugin@latest
swarm setupTool Categories
The plugin is organized into four main categories:
- Beads Tools - Git-backed issue tracking (8 tools)
- Swarm Tools - Task orchestration and parallel coordination (20+ tools)
- Skills Tools - Knowledge injection system (8 tools)
Quick Start
Basic Beads Workflow
// Session start
beads_ready() // What's next?
beads_query({ status: "in_progress" }) // What's mid-flight?
// Start work
beads_start({ id: "bd-123" })
// Complete
beads_close({
id: "bd-123",
reason: "Done: OAuth implemented with refresh"
})
// Session end (MANDATORY)
beads_sync()Swarm Coordination
// 1. Initialize swarm
swarm_init({ project_path: "/my/project" })
// 2. Decompose task
const prompt = swarm_decompose({
task: "Add OAuth authentication",
max_subtasks: 5,
query_cass: true
})
// 3. Create epic + subtasks
beads_create_epic({
epic_title: "User Authentication",
subtasks: [...]
})
// 4. Each worker agent completes via swarm_completeSkills Integration
// List available skills
skills_list()
// Load skill for current task
skills_use({
name: "testing-patterns",
context: "Breaking dependencies in AuthService"
})Architecture
The plugin is built on three core primitives:
- Beads - Git-backed JSONL issue tracker for persistent work tracking
- Swarm Mail - Event-sourced messaging with file reservations
- Learning Systems - Pattern maturity, confidence decay, outcome tracking
Next Steps
- Beads Tools Reference - Complete beads API
- Swarm Tools Reference - Decomposition and coordination
- Skills Tools Reference - Knowledge injection
- Swarm Mail Architecture - Event sourcing internals