swarm

Installation
Summary

Spawn isolated agents for parallel task execution with runtime-native team selection and fresh context per wave.

  • Auto-selects spawn backend based on runtime: Claude Native Teams in Claude sessions, Codex sub-agents in Codex sessions, or inline fallback if multi-agent unavailable
  • Executes tasks in dependency-ordered waves, spawning only unblocked tasks in parallel while respecting file ownership conflicts via pre-spawn manifest validation
  • Implements Ralph Wiggum pattern: fresh worker context per wave, TaskList as persistent state, filesystem for all artifacts, messaging for coordination only
  • Supports worktree isolation for multi-epic dispatch, OL wave integration with completion backflow, and per-task or per-wave commit policies
  • Includes scope-escape protocol for workers discovering out-of-bounds work and merge arbiter for conflict resolution during worktree reintegration
SKILL.md

Swarm Skill

Spawn isolated agents to execute tasks in parallel. Fresh context per agent (Ralph Wiggum pattern).

Integration modes:

  • Direct - Create TaskList tasks, invoke /swarm
  • Via Crank - /crank creates tasks from beads, invokes /swarm for each wave

Requires multi-agent runtime. Swarm needs a runtime that can spawn parallel subagents. If unavailable, work must be done sequentially in the current session.

Architecture (Mayor-First)

Mayor (this session)
    |
    +-> Plan: TaskCreate with dependencies
    |
    +-> Identify wave: tasks with no blockers
    |
    +-> Select spawn backend (gc if available; runtime-native: Claude teams in Claude runtime, Codex sub-agents in Codex runtime; fallback tasks if unavailable)
Related skills
Installs
647
Repository
boshu2/agentops
GitHub Stars
346
First Seen
Feb 2, 2026