How unclebob/swarm-forge works
SwarmForge’s main branch supplies a shared runtime and installer-composition source, not a standalone runnable product. Its central workflow is to compose a product, launch configured agent roles in worktrees and tmux, then exchange and complete durable handoffs; the dashboard supports operator oversight. The README documents responsibilities and broad runtime behavior, but no source excerpts were supplied, so internal call wiring and dashboard-to-command links are intentionally limited.
Main entry points: swarmforge.bb Runtime launcher · get-swarm-forge Product composer · dashboard.html Local dashboard · pack_web.bb Dashboard server
Components 20
Product composition
- Product composer
get-swarm-forge
Agent runtime
- Runtime config
swarmforge/swarmforge.conf - Runtime launcher
swarmforge/scripts/swarmforge.bb - Terminal adapters
swarmforge/scripts/terminal-adapters
Handoff lifecycle
- Handoff commands
swarmforge/scripts/swarm_handoff.bb - Handoff delivery
swarmforge/scripts/handoffd.bb - Ready checks
swarmforge/scripts/ready_for_next.bb - Work completion
swarmforge/scripts/done_with_current.bb - Merge processing
swarmforge/scripts/merge_and_process.bb
Operator controls
- Local dashboard
swarmforge/scripts/pack/dashboard.html - Dashboard requests
swarmforge/scripts/pack_dashboard_request.bb - Dashboard server
swarmforge/scripts/pack_web.bb - Board view
swarmforge/scripts/pack_board.bb
Shared guidance
- Handoff protocol
swarmforge/handoff-protocol.md - Shared agent rules
swarmforge/constitution/articles
Other components
- Operator
- AI agent
- Agent backend
- Git
- tmux
Connections 19
- Operator → Product composer: selects product
- Product composer → Runtime config: composes files
- Operator → Runtime launcher: starts swarm
- Runtime launcher → Runtime config: parses configuration
- Runtime launcher → Git: creates worktrees
- Runtime launcher → tmux: creates sessions
- Runtime launcher → Agent backend: launches agents
- Runtime launcher → Terminal adapters: selects adapter
- AI agent → Handoff commands: sends work
- Handoff delivery → AI agent: delivers handoffs
- Ready checks → AI agent: checks readiness
- Work completion → AI agent: completes work
- Merge processing → Git: merges work
- Operator → Local dashboard: oversees swarm
- Local dashboard → Dashboard server: uses dashboard
- Dashboard server → Dashboard requests: handles requests
- Operator → Board view: inspects board
- AI agent → Shared agent rules: reads guidance
- AI agent → Handoff protocol: follows protocol