# orbit

A local runtime that queues coding-agent tasks, runs them in isolated worktrees and keeps a record of how each change was delivered.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: constellation-works
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/constellation-works/orbit
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/constellation-works-orbit

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add orbit -- npx -y @orbit-tools/cli
```

### Codex

**Platform CLI**
```bash
codex mcp add constellation-works-orbit -- npx -y @orbit-tools/cli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "constellation-works-orbit": {
            "command": "npx",
            "args": [
                "-y",
                "@orbit-tools/cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "constellation-works-orbit": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@orbit-tools/cli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add constellation-works-orbit npx -y @orbit-tools/cli
```

## When to use it
- 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
- Set up Orbit for this repo
- File a task: add `hello.txt` containing hello
- Show what's running with `orbit task show <ID>`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [Orbit · noveum](https://affpapa.org/en/nevibecode/mcp/orbit.md) — ★ 69

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md