Skip to content

Home

Jump to bottom
Jeremy edited this page Mar 31, 2026 · 2 revisions

opencode-omoc-swarm Wiki

opencode-omoc-swarm is an OpenCode plugin that enables side-by-side multi-agent workflows — parallel sessions that can collaborate, compete, or divide work across isolated git worktrees.

Powered by OpenSIN — the next-generation autonomous AI ecosystem.

Quick Navigation

Section Description
Quickstart Install and run your first swarm in 5 minutes
Installation Per-project and global install options
Tools Reference All 8 swarm tools with full parameter docs
Architecture How the plugin, sessions, and worktrees fit together
Agent IDs Supported agent IDs and legacy aliases
MAX Mode Parallel editor tries with automatic winner selection
Observability Stats, history, memory, and evaluation tools
Best Practices Patterns for effective swarm usage
Development Running tests, contributing, and repo layout
Changelog Version history

What is a Swarm?

A swarm is a named group of OpenCode sessions (agents) that share a common parent session and can be orchestrated as a unit.

Parent Session (orchestrator)
├── member: plan     → OpenCode session with "plan" agent
├── member: build    → OpenCode session with "build" agent
├── member: explore  → OpenCode session with "explore" agent
└── member: reviewer → OpenCode session with "general" agent

Each member runs independently. The orchestrator can:

  • Broadcast the same prompt to all members in parallel (swarm.parallel)
  • Send a targeted message to one member (swarm.send)
  • Run MAX mode — multiple competing implementations with a selector that picks the winner (swarm.max)
  • Collaborate in the same worktree (swarm.jam)

Key Features

  • Zero friction: one swarm.create call → N parallel sessions ready
  • Registry-backed: swarm state survives session restarts via .omoc-swarm/registry.json
  • MAX mode: Codebuff-style parallel tries in isolated git worktrees; selector picks winner and patches main
  • Path reservation: prevent concurrent agents from editing the same files
  • Observability CLI: bun run observe stats|history|export + bun run memory list + bun run eval
  • Composable: works with any OpenCode agent (plan, build, explore, oracle, metis, momus, librarian)

Requirements

  • opencode on PATH
  • tmux (for bin/oc-swarm launcher)
  • curl, jq, lsof
  • The project must be a git repository (required for swarm.max)

_Sidebar

Home

Getting Started

Reference

Deep Dive

Guides

Changelog

Powered by OpenSIN

Clone this wiki locally