orbit · constellation-works — Claude Code MCP server: a task queue for coding agents
A local runtime that queues coding-agent tasks, runs them in isolated worktrees and keeps a record of how each change was delivered.
claude mcp add orbit -- npx -y @orbit-tools/cliWhat orbit does
Orbit sits on top of the agent CLI you already have signed in. The agent connects over MCP and files tasks; Orbit never holds provider API keys. Its state stays in ~/.orbit and .orbit/, and no telemetry leaves the machine.
Parallel runs are separated by sandboxes and per-file locks, so overlapping edits wait rather than collide. Delivery is gated: the agent plans, executes and reviews in a locked worktree, then opens a pull request that waits for you unless --complete was passed. Each task keeps its prompt, plan, execution trace and review verdict, and workflow commits carry the task ID. Nothing begins until you approve it.
The package installs globally from npm. You need macOS or Linux on x64 or arm64 (Windows goes through WSL2), Node 18+, a signed-in agent CLI, and authenticated gh if pull requests are part of the loop. orbit init sets the machine name, task-ID prefix and agent skills; orbit doctor inspects the environment but skips provider sign-in and MCP connectivity checks.
What it helps with
- split a long spec into parallel tasks that wait for approval
- run several agents on one repo without file collisions
- keep the prompt and review attached to every change
- take a task from plan to pull request in fixed steps
- watch progress in a local dashboard
Example prompts for the agent
- Set up Orbit for this repo
- File a task: add
hello.txtcontaining hello - Show what's running with
orbit task show <ID>
How to install orbit
Platform CLI
claude mcp add orbit -- npx -y @orbit-tools/cliPlatform CLI
codex mcp add constellation-works-orbit -- npx -y @orbit-tools/cliConfig file
{
"mcpServers": {
"constellation-works-orbit": {
"command": "npx",
"args": [
"-y",
"@orbit-tools/cli"
]
}
}
}Config file
{
"servers": {
"constellation-works-orbit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@orbit-tools/cli"
]
}
}
}Platform CLI
gemini mcp add constellation-works-orbit npx -y @orbit-tools/cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about orbit
How do I install orbit in Claude Code?
Register the MCP server with claude mcp add orbit -- npx -y @orbit-tools/cli. Then ask your agent to set Orbit up in the repo, or run orbit init yourself.
What does orbit do?
It runs a task queue for coding agents: once you approve a task, it executes in an isolated worktree under file locks and keeps the prompt, plan, trace and review on record.
What does orbit require to run?
macOS or Linux on x64 or arm64, Node 18+, an authenticated agent CLI, and a signed-in gh for pull requests. Windows is handled through WSL2.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →orbit by other authors comes first.
