get started
Three commands to a running swarm.
Nothing to sign up for and nothing to host. The marketplace installs into Claude Code, the bootstrap script writes a project overlay, and the control plane runs on your own machine.
Add the marketplace and the core
Inside Claude Code. Domain packs are opt-in on top, see Plugins.
/plugin marketplace add atretyak1985/swarmery
/plugin install core@swarmeryBootstrap a project
From a clone of the repo, in the project you want to wire up: it writes settings.json, a project.json skeleton and the project's private workspace namespace.
bash scripts/init.shInstall and run the control plane
The script fetches the release binary for your platform and verifies it against SHA256SUMS. The daemon listens on 127.0.0.1:7777, and the sessions you already ran show up at once.
curl -fsSL https://raw.githubusercontent.com/atretyak1985/swarmery/main/scripts/install.sh | bash
swarmery servethen open
127.0.0.1:7777
Today shows what waits on you, what runs now, and this week's loop. Start a plan from Plans → New plan, or just watch your existing sessions arrive.
- Binds only to the loopback interface
- Data stays in local SQLite
- Runs as a service: launchd on macOS, systemd
--useron Linux
optional
Extras.
Notch
A small tab docked to the screen edge that expands into a side panel on its own when an operator is needed: a pending approval or a failed session. Native, zero dependencies.
Build it yourself
Go and React, one make build: docs snapshot, Vite bundle, go:embed, one binary. make install swaps the service-managed binary and restarts it.
Add a domain pack
UAV, IoT, web, infra, code graphs, Jira, PR review, design handoff and more. Enable only what a project uses.
Plugins, skills, scripts, overlays
Free to use and build on anywhere, including commercial work.
The Go binary
Free for personal, learning, research and open-source use. Read the terms for anything commercial.
Stuck somewhere?
Open an issue on GitHub. Questions and pull requests are welcome.