v1.0.3 is out · macOS · Linux · WSL2

Mission control for your Claude Code sessions.

Run many Claude Code sessions across every project and git worktree you own, from one terminal, one keyboard, one screen. They keep working after you close it.

$ curl -fsSL https://raw.githubusercontent.com/AmenAdem/Orbit/main/install.sh | sh
Orbit: project tabs with status dots across the top, a band of session cards per checkout, and the running session's terminal beside them

Why Orbit

Stop reading screens. Read a colour.

You start three Claude sessions in three terminal tabs. Five minutes later you don't know which one is waiting on a permission prompt, which one finished, and which one is still thinking, so you tab through them all and read.

Orbit replaces the reading with a grid and a colour. Every session is a card with a status dot. Cards sit in a band per git checkout, under project tabs that add up their sessions' dots. A red ●1 on a tab tells you exactly where to look.

One Rust binary and a unix socket. No Electron, no browser, no server.

  • Yellowworking on a turn
  • Redwaiting on you: a prompt or a question. Plays a sound.
  • Bluefinished, and you haven't looked yet
  • Greenfinished, and you've seen it

Features

Everything a day of parallel agents needs.

Built for a Claude-first workflow: many sessions, many worktrees, one screen, and keys you can remember.

⏎

One screen, every session

Project tabs, a band per worktree, a card per session, and the live terminal of the card under the cursor beside them.

;

Dots instead of screens

Every card and every tab counts its dots. Red sends a desktop notification, and ; jumps to the next session that needs you.

q

A daemon owns the sessions

Quit Orbit, close the laptop, come back tomorrow: the sessions never stopped, and their output is replayed when you return.

p

A task box, not a picker

p, type the task, Enter. Ctrl+N runs it in a fresh git worktree so parallel agents never edit the same files.

^S

Skills, several at once

Tick exactly the skills a prompt should use, personal, project or plugin. Save a set as a workflow and commit it for your team.

%

Limits and context at a glance

The footer shows your plan's 5-hour and weekly use, and each card shows how full its context is: amber from 80%, red from 95%.

k

Code graph, built in

A graphify knowledge graph of every checkout, kept fresh with no LLM, so Claude queries the graph before grepping file by file.

g

Review without leaving

Diff with reviewed marks, a full-screen git graph, fuzzy file finder, search in files and a file tree, all scoped to the card's checkout.

v

GitHub in place

Every band shows its branch's pull request. Read, diff and comment on PRs, or start a session on any issue. Needs gh.

F10

Claude drives Orbit back

Say "do this in a worktree" or "start a session that writes the tests" and the session runs the right orbit command itself.

h

Keys you can remember

Arrows to move, letters that mean something, nothing that needs ⌥ or a dead key on an AZERTY Mac. Every key is rebindable.

✓

One-time setup check

orbit doctor shows what your machine has and what each missing piece unlocks. --fix installs the integrated tools once.

Install

Up and running in two minutes.

Pick your system. The same command installs and updates; prebuilt binaries cover Apple Silicon, Intel Macs, and x86_64 / ARM64 Linux.

  1. Install what Orbit needs

    Git, uv and npm through Homebrew (gh is optional, for pull requests and issues), then Claude Code itself.

    $ brew install git uv node gh
    $ curl -fsSL https://claude.ai/install.sh | bash

    Other ways to install Claude Code: official setup guide. Sign in once by running claude.

  2. Install Orbit

    With Homebrew recommended

    $ brew tap amenadem/orbit https://github.com/AmenAdem/Orbit
    $ brew install amenadem/orbit/orbit

    Type the full name amenadem/orbit/orbit. A plain brew install orbit installs an unrelated Mac app.

    Or with the install script, into ~/.local/bin:

    $ curl -fsSL https://raw.githubusercontent.com/AmenAdem/Orbit/main/install.sh | sh
  3. Check your setup and start

    $ orbit doctor --fix   # installs graphify and agent-browser once
    $ cd ~/code/my-app && orbit

Requirements

ToolWhat it's for
gitprojects, worktrees, diffsrequired
claudethe Claude Code CLI Orbit runsrequired
uvinstalls graphify for the code graphrequired
npminstalls agent-browser for browser testingrequired
ghpull requests and issuesoptional
mmdcrenders Mermaid diagrams in the vieweroptional
Rustonly when building from sourceoptional

Orbit installs graphify and agent-browser itself, once per machine, the first time each is needed. Run orbit doctor any time to see what's missing.

Platforms

SystemArchitecture
macOSApple Silicon (arm64)prebuilt
macOSIntel (x86_64)prebuilt
Linuxx86_64 (static musl)prebuilt
Linuxaarch64 (static musl)prebuilt
WindowsWSL2, as Linuxsupported
Windowsnative or WSL1not supported
Anything elsewith cargofrom source

Updating

When a release is out, Orbit's footer shows ⇡ vX.Y.Z. One command updates and moves the running daemon onto the new binary without stopping a session:

$ orbit upgrade

After a plain brew upgrade, run orbit reload to do that last step yourself.

Uninstalling

$ orbit kill                       # stops the daemon and every session
$ rm ~/.local/bin/orbit            # script install
$ brew uninstall amenadem/orbit/orbit   # Homebrew

Settings and the session database live where orbit config path points; remove that folder too for a clean slate.

Quickstart

Your first session.

Open a terminal inside a repository and run orbit. Then:

  1. 1
    On the splash screen press Enter to open the repository you're in. Anywhere else, o browses for a folder.
  2. 2
    Press p, type what you want done, press Enter. A card appears with a yellow dot.
  3. 3
    Do something else. When the dot turns blue or red, press ; to land on it and Enter to step in. Ctrl+Q steps back out.
  4. 4
    q quits, and the sessions keep running. Run orbit again to pick them up.

Sessions name themselves from your first prompt (Fix Login Redirect, not agent-3). Press h any time for every key.

The keys that matter

↑↓←→
move between bands and cards
Enter Ctrl+Q
step into a session · back out
p Space
new task · follow-up to the card
; ,
next / previous session that needs you
j
jump to any session
< > +
switch project · list them all
g l k
diff · git graph · code graph
f ⇧F b
find file · search · file tree
v i
pull requests · issues
s h q
settings · help · quit
Every key and the mouse →

Contribute

Open source, MIT, and young.

Bug reports, doc fixes and focused pull requests are all welcome. Orbit moves fast, so small changes land quickest.

  1. Fork and build
    $ make dev   # isolated copy: own daemon, own data
  2. Run the gate CI runs
    $ make ci    # fmt, clippy -D warnings, tests
  3. Open a pull requestOne topic per PR, docs updated with it, a screenshot for anything on screen.
Amen Adem Thabti

Built by

Amen Adem Thabti

Developer · Tunisia

I build Orbit for the way I work every day: several Claude Code sessions at once, each in its own worktree, all on one screen. It started as a fork of nebula and has been reshaped around a Claude-first workflow, with skills per prompt, a built-in code graph and keys that work on any keyboard.

Give every session a dot.

$ curl -fsSL https://raw.githubusercontent.com/AmenAdem/Orbit/main/install.sh | sh

or see every install option