Skip to content

Robdel12/OrbitDock

Repository files navigation

OrbitDock

Mission control for AI coding agents. Manage Claude Code and Codex sessions from your Mac or your phone — create sessions, review diffs, approve tools, and steer agents from anywhere.

macOS iOS Swift Rust License

demo-compressed.mp4

Why

I don't write code anymore (pretty much) — agents do. My job is reviewing, managing, and providing guidance at the right time. But with multiple repos and a bunch of agents running across all of them, keeping track of it all was chaos. OrbitDock is how I'm trying to wrangle that.

A Rust server sits at the center. It creates and runs both Claude Code and Codex sessions directly — Codex via embedded codex-core, Claude via the CLI. It also picks up existing Claude Code terminal sessions through hooks. Run a server on your laptop, your work machine, a VPS, wherever your agents are. The macOS and iOS apps connect to all of them at once, so you get one unified view no matter where your sessions are running or what device you're on.

What You Get

  • Run agents from anywhere — Create Claude and Codex sessions from Mac or iOS, no terminal needed
  • Live monitoring — Every session across every project, updating in real time
  • Code review — Magit-style diffs with inline comments that steer the agent
  • Approval triage — Diff previews, risk cues, keyboard shortcuts (y/n/!/N)
  • Direct control — Send messages, approve tools, interrupt, run shell commands
  • Usage tracking — Rate limit monitoring for Claude and Codex
  • Multi-server — Connect to local, remote, and cloud endpoints at once

See FEATURES.md for the full list.

Quickstart

Get this running locally in a few minutes.

1. Install the server

curl -fsSL https://raw.githubusercontent.com/Robdel12/OrbitDock/main/orbitdock-server/install.sh | bash

The installer sets up the binary, shell PATH, data directory, database, Claude hooks, and background service.

2. Verify it started

orbitdock-server status
orbitdock-server doctor

doctor runs a full diagnostic — database, hooks, encryption key, disk space, port availability, and more. If something's wrong, it'll tell you.

3. Open the app

Download from Releases and run it.

Or build from source:

git clone https://github.com/Robdel12/OrbitDock.git
cd OrbitDock
make build

You can also open OrbitDock/OrbitDock.xcodeproj in Xcode and hit Cmd+R.

The app auto-connects to the local server.

4. Authenticate your providers

Codex — Open Settings → CODEX CLI → Sign in with ChatGPT (or use API key auth mode).

Claude Code — Install the Claude Code CLI and log in. The installer already set up hooks, but if you skipped that step: orbitdock-server install-hooks.

5. Create a session

Click New in the top bar and pick Claude Session or Codex Session. Select a project directory, choose your model, and go.

Existing Claude Code terminal sessions show up automatically through hooks.

If something doesn't appear, run orbitdock-server doctor and check ~/.orbitdock/logs/server.log.

Remote server

Running on a VPS, Raspberry Pi, or another machine:

orbitdock-server setup --remote

See DEPLOYMENT.md for Cloudflare tunnels, TLS, Docker, and more.

Requirements

  • macOS 15.0+ (iOS 18.0+ for mobile)
  • Codex — Built in. The server embeds codex-core. Authenticate with ChatGPT sign-in or API key
  • Claude Code — Requires the claude CLI installed and logged in. OrbitDock creates sessions directly or monitors existing ones via hooks
  • Xcode 16+ and Rust stable toolchain if building from source

Documentation

License

MIT

About

Mission control for AI coding agents. Monitor all your Claude Code and Codex CLI sessions from one native macOS dashboard.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages