Install Orbit

Platform Support

Orbit’s CLI runs on macOS, Linux, and Windows, but OS-level sandbox enforcement of agent subprocesses is currently macOS only, via sandbox-exec. The bundled claude, codex, and gemini executors declare sandbox: macos-sandbox-exec and require macOS to launch with a sandbox; on Linux and Windows the same activities run, but the spawned agent process is not wrapped in a kernel-level sandbox. Filesystem policies still apply to Orbit’s own HTTP-tool builtins on every platform.

Install

The recommended install is the install script:

curl -sSf https://raw.githubusercontent.com/danieljhkim/orbit/main/install.sh | sh

It detects your platform, downloads the matching release binary, and places it on your PATH.

Alternatives

Homebrew (macOS, Linuxbrew):

brew install danieljhkim/tap/orbit

Claude Code plugin (skips the install script, downloads the binary on first MCP call):

/plugin marketplace add danieljhkim/orbit
/plugin install orbit

The plugin registers Orbit’s MCP server, skills, and orchestration subagents in Claude Code, and pulls the matching native orbit binary through the @orbit-tools/cli npm proxy on first invocation. Requires Node 18+ on PATH. To get the orbit CLI on your shell as well: npm install -g @orbit-tools/cli.

From source (requires Rust toolchain):

git clone https://github.com/danieljhkim/orbit.git
cd orbit
make install

Pinned versions and custom install directory

curl -sSf https://raw.githubusercontent.com/danieljhkim/orbit/main/install.sh | ORBIT_VERSION=v0.1.0 sh
curl -sSf https://raw.githubusercontent.com/danieljhkim/orbit/main/install.sh | ORBIT_INSTALL_DIR="$HOME/.local/bin" sh

Initialize State

Orbit has global state and workspace-local state.

orbit init
cd <repo>
orbit workspace init

orbit init seeds default skills under ~/.orbit/skills and links them into ~/.agents/skills and ~/.claude/skills. Workspace skills are optional overrides by skill name.

Pass --no-mcp if you want workspace initialization without MCP client setup:

orbit workspace init --no-mcp

Build the Graph

Build the initial repository graph before asking agents to reason over code structure.

orbit graph build

You can later update it incrementally:

orbit graph update