multi-agent development orchestrator
One config file.
A whole chorus of agents.
Define the team in .choragos.toml: the roles, the CLI agent each one runs, and
the model behind it. Choragos runs the chorus: owned PTY panes per agent, a
delegate/work-done protocol, approval and judge gates, checkpoints, and live token and cost
telemetry.
# CLI (macOS / Linux)
brew install sphragis-oss/sphragis/choragos
# or the native macOS app, CLI bundled
brew install --cask sphragis-oss/sphragis/choragos-desktop
why choragos
Built for agents that actually ship
Owned PTY panes
Each agent runs in a pseudo-terminal Choragos owns and parses, so it knows real input readiness instead of polling a status that lies. No boot races.
Delegate / work-done
The orchestrator hands work to workers over a local UNIX socket with
choragos delegate; workers report back with choragos work-done.
Compliance in the path
Route every agent's LLM traffic through the Sphragis gateway for local PII redaction and a tamper-evident audit log. Fail-closed when you ask for it, fully optional otherwise.
Live cost telemetry
Per-role model, token counts, and dollar cost on each status card. Set
budget = "5.00" on a role to be notified, or have it paused, the moment it
crosses the cap.
Runtime control
Delegation timeouts catch a worker stuck in a loop, and prefix+p freezes a
role so you can inspect mid-flight and resume without losing its context.
Least privilege per role
Opt-in env_allow / env_deny per role, so a reviewer never sees
your AWS_* credentials. OS-level isolation composes from outside.
quick start
Init, serve, report
Install
# CLI
brew install sphragis-oss/sphragis/choragos
# or the native macOS app, CLI bundled
brew install --cask sphragis-oss/sphragis/choragos-desktop
Or build from source with Go 1.26+: make build. Releases are cosign-signed
with checksums and provenance.
Run
# starter config: roles, keys, UI
choragos init # or --template review, --auto
# start the deck (TUI)
choragos serve
# tasks, durations, token burn per role
choragos report Sessions detach like tmux. choragos serve --detach runs the
crew headless, choragos attach brings the deck back with screens, tasks, gates,
and layout restored. choragos ls and choragos kill manage sessions
across projects.
the default team
Every role, your call
The team is completely configurable. Each role's agent binary and model is user-overridable; this is just the default cast.
| Role | Default agent | Job |
|---|---|---|
orchestrator | claude (opus) | plans and delegates, never implements |
coder | claude (opus) | implements changes |
reviewer | agy (Gemini) | reviews diffs, reports only |
auditor | claude (sonnet) | security audit, reports only |
release | claude (haiku) | runs the release flow after human sign-off |
open source
Enjoying the show?
Choragos is Apache-2.0 and built in the open. If it earns a place in your workflow, a star on GitHub helps other teams find it.