{
  "mcpServers": {
    "orbiter-dev": {
      "command": "npx",
      "args": ["-y", "@orbiterdev/mcp-server@latest"],
      "env": {
        "ORBITER_SERVER_URL": "https://api.orbiterdev.ai"
      }
    }
  }
}

For Cursor: Settings → MCP → Add Server. For Windsurf: use MCP settings panel.

Pair with Mobile

When an agent uses the MCP tools, it will prompt you to pair:

The agent calls orbiter_auth with the code from your mobile app
Open Orbiter Dev app → Settings → Pair IDE
Copy the pairing code (e.g. ORBIT-K7N3) and provide it to the agent
The agent verifies — you're connected!

Available MCP Tools

Tool	Purpose
orbiter_auth	Pair IDE with mobile app
request_approval	Request human approval for risky actions
agent_heartbeat	Report agent state (working, idle, error)
checkpoint_post	Log progress milestones
notify_user	Send push notification to phone

⚡

Claude Code Hooks (Optional)

Get mobile push notifications for agent lifecycle events. Add to .claudecode.json:

{
  "hooks": {
    "PostToolUse": {
      "command": "npx @orbiterdev/mcp-server notify --event 'Tool Done' --message '{{tool_name}} completed'",
      "async": true
    }
  }
}

🧩

IDE Extension Setup

For Antigravity and VS Code. The extension integrates directly with the IDE's sidecar for automatic approval detection — no config files needed.

Install the Extension

Download the latest VSIX file and install:

Option A: Command Line

antigravity --install-extension orbiter-dev-0.8.1.vsix --force

Option B: IDE UI

Ctrl+Shift+P → "Extensions: Install from VSIX" → select the .vsix file

Login & Pair

Open command palette: Ctrl+Shift+P
Run: Orbiter: Login with GitHub
Run: Orbiter: Connect Device to pair your phone
The onboarding walkthrough will guide you through mode selection

Approval Modes

Mode	Behaviour	Best For
🟢 TURBO	Auto-approves safe ops, blocks destructive	Speed
🟡 AUTO	Prompts for writes/commands, auto-approves reads	Daily dev
🔴 ALWAYS	Every action needs approval	Production

Change anytime via: Ctrl+Shift+P → Orbiter: Set Approval Mode

📱

Mobile App

The Orbiter Dev iOS app is your remote control for AI agents. Receive push notifications, review diffs, and approve actions from anywhere.

Install

Available on TestFlight (iOS). Request an invite at hello@orbiterdev.ai.

Pair Your IDE

Open Orbiter Dev app → login with GitHub
Go to Settings → Pair IDE
A pairing code appears (e.g., ORBIT-K7N3)
Enter this code in your IDE when prompted
Your devices are now synced!

Approval Workflow

📲 Push Notification

Your agent tries a risky action → you get a push notification instantly.

👁️ Review Details

Tap to see: action type, affected files, risk level, diff summary, and agent context.

✅ Swipe to Decide

Swipe right to approve, left to reject. The agent resumes or stops immediately.

Features

🛡️ FaceID for high-risk approvals (production deploys, data deletion)
📊 Agent HUD — real-time heartbeat, progress checkpoints
🔇 Zero Data Mode — no code content transmitted, metadata only
👥 Playgroups — shared workspaces for team approval workflows
🌙 Offline Queue — approvals cached locally when offline

⚖️

Extension vs MCP — Which One?

Feature	🧩 Extension	🔌 MCP	🧩+🔌 Both
Antigravity	✅	✅	✅
Claude Code	—	✅	✅
Cursor / Windsurf	—	✅	✅
Auto detection (no agent config)	✅	—	✅
Policy Engine (TURBO/AUTO/ALWAYS)	✅	—	✅
Agent heartbeats	✅	✅	✅
Push notifications	✅	✅	✅
Session cost tracking	✅	—	✅
Zero-install setup	VSIX file	✅ npx	VSIX + npx

Recommendation: If you use Antigravity, install the extension for the deepest integration. If you use Claude Code or Cursor, the MCP server is all you need. For the ultimate setup, use both.

❓

Documentation

Which setup do you need?

MCP Server

IDE Extension

Mobile App

MCP Server Setup

Prerequisites

Add to Claude Code

Pair with Mobile

Available MCP Tools

Claude Code Hooks (Optional)

IDE Extension Setup

Install the Extension

Login & Pair

Approval Modes

Mobile App

Install

Pair Your IDE

Approval Workflow

Features

Extension vs MCP — Which One?

FAQ & Troubleshooting