Orbit's local-first task and workflow registry for coding agents.
Orbit MCP Server (io.github.constellation-works/orbit)
Orbit provides a local-first task and workflow registry for coding agents. It is positioned around an engineering framework that includes an Orbit dashboard (“orbit web serve”) with a task backlog, live audit log, and per-agent scoreboard, supporting durable task management and structured review.
🛠️ Key Features
Local-first task and workflow registry for coding agents
Orbit dashboard: task backlog
Live audit log and per-agent scoreboard
Structured audit of tool calls and provider exchanges
Conflict-aware parallel dispatch
🚀 Use Cases
Managing coding-agent workflows using a durable task backlog
Tracing and auditing agent activity via a live audit log
Coordinating parallel agent execution with conflict awareness
⚡ Developer Benefits
Review and audit data are structured around tool calls and provider exchanges
Agent execution can be monitored through a dashboard and scoreboard
⚠️ Limitations
No tool count details are provided in the available server data.
Animated tour of the real Orbit dashboard while Orbit's agents work on Orbit itself: proposed tasks waiting for approval, each showing its regression risk and what its pilot found; tasks in progress with 17 files locked so overlapping work waits; an auto-drain with 5 running and 15 admitted in 5 of 7 slots, its CPU and memory forecast, its backlog estimate, and the window and after-ship rules you set; one task's record of who created, piloted and implemented it, with its acceptance criteria, pull request and run; a pull-request run from isolated worktree to landing, 34 steps in 18 minutes 11 seconds; 47 auto-task definitions, 43 enabled, that keep the queue fed; analytics showing 6,894 tasks done in 30 days, 217% more than the 30 days before; experiments that split real tasks between crews and compare cost, duration and first-pass acceptance; a ranking of every crew on one score; and the codebase view showing the paths agents struggle with across 11,190 tasks.
Orbit is a local-first runtime for coding agents. Keep using your authenticated agent CLI; Orbit adds a durable task queue, sandboxed worktrees, file locks for parallel runs, a gated delivery pipeline, and an audit log.
Why: fast agents make planning, review, and traceability easy to lose. Orbit keeps the prompt, plan, and review behind every change, with a task ID on every workflow commit.
Single binary, no cloud. State lives in ~/.orbit and .orbit/; Orbit sends no telemetry.
Bring your own agents. Use the provider CLIs you already have authenticated, without giving Orbit API keys.
MIT licensed. No paid tier or hosted offering.
How it works
text
You: The fsProfile lookup is undocumented. Get that fixed.
Agent: Files a proposed task with acceptance criteria. Approve it and ship?
You: Yes.
Agent: Queues it, then runs plan → execute → review in a locked, isolated worktree.
Opens a pull request. Review and merge it, then approve the task to close it.
Nothing starts without approval; PR runs stop for your review unless you authorize --complete. The task record keeps the prompt, plan, execution trace, and review. For larger specs, ask your agent to orchestrate: the bundled orbit-orchestrate skill splits the work, queues it once approved, runs it in parallel, and diagnoses failures (delivery workflows).
Platforms
Platform
Support
macOS and Linux
Supported on x64 and arm64
Windows
Via WSL2; not yet verified on a Windows host. Native Windows is not supported.
Quick start
You need: a supported platform, Node 18+, an authenticated agent CLI, and authenticated gh for pull requests.
bash
npm install -g @orbit-tools/cli
orbit init # machine name, task-ID prefix, agent skills, and Linux sandbox setup
Open your agent in the repo and ask it to “set up Orbit for this repo”. The bundled orbit-setup skill registers it, connects MCP, runs orbit doctor, and asks for choices such as the PR target branch. Start a fresh agent session, then ask: “Add a hello.txt file containing hello; file it as an Orbit task.” Approve and ship the task when prompted, review and merge the PR, then approve the task to close it. Watch with orbit web serve.
cd <repo> && orbit workspace init --mcp # add --ship-mode local to skip PRs
orbit doctor
orbit web serve
Review and commit the checkout files listed by workspace init, including MCP client files, before the first ship. Local delivery refuses tracked changes, merge conflicts, and untracked paths overlapping incoming changes.
orbit doctor checks CLI presence for default, system, and complexity-routed crews and warns when no MCP client is registered; it does not check provider sign-in or MCP connectivity. Use orbit doctor providers for all executor definitions. See Linux sandbox readiness and distro coverage.
To…
Run
Inspect a task or run
orbit task show <ID> · orbit run show <RUN_ID>
Open the dashboard
orbit web serve (remote: orbit web connect <host>)
CHANGELOG.md: Orbit is pre-1.0, and breaking changes ship in minor releases
Contributing
Pull requests are welcome, from typo fixes to new executors. Small fixes can go straight to a PR; bigger changes start with an issue. See CONTRIBUTING.md.