Back to Overview

SwarmCoordinator

Agent Orchestration

The SwarmCoordinator manages agent lifecycle, work distribution, and health monitoring. Each agent runs through the model-agnostic AgentHarness, supporting Claude Code, Codex, Gemini, browser agents, or custom models. Default claim strategy is best-fit.

[SWARM COORDINATOR]

Autonomous Task Worker (AgentHarness)

_

AGENT STATUS
heartbeat #0
1. idle
2. looking
3. claiming
4. retrieving
5. executing
6. storing
7. publishing
8. complete
SKILLS
typescriptreactdatabasetestingdevopspython
TASK QUEUE
<refactor_auth_module/>
typescript
<add_user_dashboard/>
react
<optimize_db_queries/>
database
<write_api_tests/>
testing
<setup_ci_pipeline/>
devops
AGENT HARNESS (ANY LLM)
status:awaiting work
01 / START

SwarmCoordinator subscribes to Agent Mail, starts heartbeat every 30s, begins work loop.

02 / CLAIM

Get ready tasks, filter by skills, sort by priority, claim highest match.

03 / EXECUTE

Retrieve memory context, spawn AgentHarness with any LLM, capture output.

04 / COMPLETE

Store learnings in Memory System, publish completion via Agent Mail.

AgentHarness Lifecycle

Register
Poll Tasks
Claim (Atomic)
Broadcast Intent
Execute
Store Learnings
Loop

Model-Agnostic Execution

AgentHarness wraps any LLM CLI for task execution:

claude --print --dangerously-skip-permissions "<task prompt>"

The agent captures stdout/stderr, monitors for completion, and reports results back through Agent Mail.

Supported Skills

Agents can be configured with any combination of skills:

typescriptjavascriptpythonrustgoreactvueangularsveltebackendfrontenddatabasedevopstestingdocumentationsecurity

Claim Strategies

5

Claim strategies available

Any

LLM model supported

Tasks per session

Configuration

Start agents via CLI with skill-based registration:

# Start swarm with 5 agents using smart prioritization
jetpack start -a 5 --strategy graph-prioritized

# Or join as a single agent with specific skills
jetpack agent --skills typescript,react,frontend