swarm-orchestrator
swarm-orchestrator is a coding agent that executes tasks in a git workspace while recording every action as signed, hash-chained evidence. It solves the problem of trusting an AI's claims by making gates and verification harness-controlled, and exports bundles that can be independently verified. It is for developers who want auditable AI-assisted coding.
✨ Key features
- Plans tasks and declares files before editing
- Records every tool call through a chokepoint
- Runs gates and retries failures with a numeric ratchet
- Exports signed, hash-chained evidence bundles
- Supports parallel workers with merge queue and redundancy
- Interactive TUI with session mode and plain output
🎯 Use cases
- Automate code changes with verifiable evidence
- Run parallel coding tasks with redundancy
- Audit AI coding agent actions
- Integrate into CI with plain output
📦 Installation
🧰 Requirements: Node 24 or newer. API keys for ANTHROPIC, OPENAI, or GOOGLE_GENERATIVE_AI, or a local model server like Ollama.
npm install -g swarm-orchestrator
That is 13.1.9, and it leaves swarm on your path.
Installing from a tag works too, but only into a project rather than globally:
npm install github:moonrunnerkc/swarm-orchestrator#v13.1.9
🚀 Usage
swarm "make slugify collapse whitespace and strip punctuation"
For a session:
swarm
⚠️ Good to know
The tool makes no judgement about whether a set of tasks adds up to a goal; it only checks structural properties.
❓ FAQ
What Node version is required?
Node 24 or newer is required because the coverage cycle uses --test-isolation=process, which Node 22 rejects.
How do I use a local model?
Start Ollama or rapid-mlx and pass --model local: to use a local model.
Can I verify a bundle without installing the tool?
Yes, each bundle includes its own verifier (verify.mjs) that can be run with Node.
What happens if I install from a git tag?
Installing from a git tag builds from source and requires devDependencies, so it's recommended to install the published package instead.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.