open source · local-firstnew: feature episodes

Run your Claude Code agents like a fleet.

One local control plane for every Claude Code session: plan the work through an interview, run it in isolated worktrees, answer every waiting agent from one queue, and see what it cost. One Go binary, no cloud, no account.

Get started
>/plugin marketplace add atretyak1985/swarmery
LIVE
3agents waiting on youinbox · oldest 7m
$cost before the billper session · project · model
16
plugin packs
26
agents
70
skills
:7777
local control plane
before
Alt-tab. Copy. Which agent is stuck?

Ten terminals, three repos, and a permission prompt you missed an hour ago. Swarmery shows every session live and puts every waiting decision in one queue.

before
The agent said "done".

A process exiting 0 is not a finished phase. Work is checked against its acceptance criteria from the outside, and the report says what actually shipped.

before
Same mistake, every week.

Runs that miss their forecast become lessons with evidence. You accept them, they reach future runs, and they are re-measured until they stop helping.

the loop

Plan, run, decide, measure, learn. One loop, one dashboard.

Every stage feeds the next, and amber always means something there is waiting on you. Click a stage, or let it play.

control plane

One binary that watches the whole swarm.

A single Go daemon with an embedded React dashboard. It reads the session transcripts Claude Code already writes, indexes them into local SQLite, and serves everything on one port that never leaves the loopback interface. Nothing to install in your projects.

  • Sessions you already ran show up at once
  • Approvals reach your phone, so a waiting run is unblocked away from the desk
  • launchd on macOS, systemd on Linux
~ zsh
$ swarmery serve
swarmery · single binary
✓ backfilling sessions from ~/.claude/projects
✓ listening on 127.0.0.1:7777
✓ ready · nothing leaves this machine
113
Go packages
260
REST routes
:7777
dashboard port
127.0.0.1
the only interface it binds

plugin marketplace

One set of agents. Every project.

Stop copy-pasting agents between repos. A vendor-neutral core carries what is true for every project, opt-in packs add the vocabulary of one kind of work, and each project brings its own flavor at runtime through project.json.

watch

A series, one feature per episode.

Under two minutes each, with chapters you can jump between.

why it holds together

Six rules, each enforced by something you can run.

A scan, a gate, a worktree, a verdict. None of them is a convention you have to remember.

neutrality

A core that names no one

Brand tokens are forbidden anywhere under plugins/, and a CI ratchet keeps the count at zero. Each project's flavor arrives at runtime from its own project.json.

graduation

Flow goes up only

A component is born project-local, moves to a domain pack when a second project needs it, and reaches the core only when every project does. Nothing is copied downward.

isolation

One worktree per run

Every phase run and every dispatched task gets its own branch in an isolated git worktree. Your working tree is never the agent's workspace.

verification

Verdicts that can say no

A read-only verifier diffs the work against the persisted start point and returns PASS, FAIL or INCONCLUSIVE. Done means the criteria are ticked and the report is written, not that a process exited 0.

plans

A phase graph, not a wish list

Every phase carries measurable acceptance criteria, a forecast and a completion report. Runs execute the graph in dependency order, and the markdown on disk stays the source of truth.

observability

Everything on the record

Every session transcript is indexed into local SQLite: tokens, cost, approvals, forecasts against actuals, and the lessons drawn from the gap. Nothing leaves the machine.

license

Two licenses, and honest about both.

Apache-2.0 · the framework

Every agent pack, skill, script and overlay

Readable, forkable and yours to build on anywhere, including inside a company's paid workflow, at no cost.

PolyForm Noncommercial · the control plane

The Go binary under tools/swarmery/

Free for personal projects, learning, research and other open-source work. Commercial use is the one thing it does not grant: read the terms and get in touch.

Run your agents like a fleet.

Free on GitHub. One binary on your machine, no cloud, no account. Your sessions show up the moment it starts.