<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="assets/orbit_logo_white.png">
<source media="(prefers-color-scheme: light)" srcset="assets/orbit_logo_black.png">
<img src="assets/orbit_logo_black.png" alt="Orbit" width="300">
</picture>
</p>
<h1 align="center">Orbit</h1>
<p align="center"><strong>One workbench for your Claude Code projects.</strong></p>
<p align="center"><em>Plan, execute, track, and resume - without losing state.</em></p>
<p align="center">
<img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg">
<img alt="Python 3.11+" src="https://img.shields.io/badge/Python-3.11%2B-blue.svg">
<img alt="Claude Code Plugin" src="https://img.shields.io/badge/Claude%20Code-Plugin-purple.svg">
</p>
Orbit is the project layer for Claude Code. Every orbit project gets a durable home: a plan, a living context file, and a task checklist. That state persists across sessions, survives context compaction, and reloads when you come back. On top of that foundation, orbit adds time tracking, a local analytics dashboard, autonomous execution, and a rich statusline, so multi-session work has one place to live and one place to watch.
<!-- HERO GIF: dashboard + statusline + /orbit:new flow -->
Contents
Why Orbit
Your projects keep their memory
Every orbit project lives under ~/.claude/orbit/active/<project-name>/ as three markdown files: plan.md (the agreed approach, locked after approval), context.md (your decisions, key files, gotchas, and next steps as a living document), and tasks.md (a hierarchical checklist with progress). Claude Code sessions end, context windows compact, but your project state stays put. Run /orbit:go <project-name> in any new session and orbit reloads the full state. You pick up where you left off with your plan, your decisions, and your next steps already loaded.
Full visibility into your Claude time
Orbit tracks heartbeats while you work, aggregates them into sessions, and shows per-project, per-repo, per-day, and per-week breakdowns on a local web dashboard at localhost:8787. It merges orbit's own heartbeat data with Claude Code's JSONL session logs, so the picture includes time you spent in Claude sessions that were not formally tracked. You always know which projects are actually eating your cycles.
Autonomous execution you can watch live
Orbit Auto runs project tasks in parallel with dependency-aware DAG scheduling, logs every iteration in real time, and streams execution state to the dashboard. You can watch the whole run as it happens or walk away and check the iteration log afterward. Every task, every attempt, every outcome is visible.
Orbit exists because no single existing tool integrates all three. See How Orbit compares for the honest breakdown against the current field.
Install
Orbit ships in two flavors. Pick based on whether you want the full workbench experience (recommended) or just the plugin core.
Full install (recommended)
Gets you everything: the plugin core (slash commands, MCP tools, hooks, rules), the local dashboard at localhost:8787, the orbit-auto CLI for autonomous execution, and the multi-line statusline. This is the experience Orbit was designed to deliver.
git clone https://github.com/tomerbr1/claude-orbit.git
cd claude-orbit
./setup.sh
The interactive script will:
- Register orbit in a local marketplace and install the plugin core
pip install -e the orbit-db package so orbit-auto can log execution runs to the dashboard- Install the Orbit Dashboard and wire it up as a background service (launchd on macOS, systemd on Linux)
pip install -e the orbit-auto CLI- Optionally install the statusline and configure health monitoring
Requirements: Python 3.11+, Claude Code CLI, pip, and uvx on your PATH (needed by the plugin's MCP server). If uvx --version fails, install uv first with pip install uv or curl -LsSf https://astral.sh/uv/install.sh | sh.
Plugin-only install
If you only want the plugin core (slash commands, MCP tools, lifecycle hooks, orbit rules) and don't need the dashboard, orbit-auto CLI, or statusline, you can install Orbit as a pure Claude Code plugin via the marketplace.
In Claude Code:
/plugin marketplace add tomerbr1/claude-orbit
/plugin install orbit@claude-orbit
Restart your Claude Code session.