See everything Claude Code does.
Orbit is a live, animated window into Claude Code. Every file Claude reads, every command it runs and every change it makes appears on a map in your browser the moment it happens. You can run Claude right inside Orbit, replay any session, read any past conversation, and see what each prompt cost.
Everything runs on your own computer. Nothing is sent anywhere.
- Live map. Claude sits at the centre and your files, the terminal, web, search and MCP tools orbit it. Each action fires a beam of light. Edits spark, failures flash red, and sub-agents appear as their own satellites.
- Every step in full detail. Click any step to see it. Double-click, or press Expand, to open it full screen. Code changes type themselves in as a before-and-after diff with line numbers. Commands play out in a terminal window, the command typed first and then its output. A side list shows everything that happened to the same file. Turn on Follow live and each new step opens there as Claude works.
- Files tab. Every file read or changed, with lines added and removed. Click one to step through its full change history.
- Search and filters. Find any step by text, or show only edits, reads, commands, searches, web, agents, MCP, prompts or failures. Press
/to search. - Replay. Play any session back on the map, at 1× to 30× speed, with a scrub bar.
- Cost and plan usage. A rolling odometer shows the estimated cost of each session and each prompt, with a breakdown of where the tokens went. Rings show your Pro or Max plan's 5-hour and weekly limits, with reset times, and how full the context window is.
- Chats. Every conversation Claude Code has saved on your computer, including ones from before Orbit was installed. They're grouped by project, can be searched (inside the text too), and show as clean chat: your messages, Claude's formatted replies, and each run of tool steps folded into one expandable row. From any conversation you can carry it on in the workspace, show it on the map, replay it, or export it.
- Workspace. Start Claude sessions from the browser. The real, unmodified Claude Code runs in a built-in terminal, signed in with your own account, beside the live map. Run several in tabs.
- "Claude needs you" alerts. When Claude asks permission or waits for an answer, the workspace glows amber, shows exactly what it wants, and can send a desktop alert.
- Shareable reports. One click gives a self-contained HTML page or Markdown file with what you asked, the files changed with diffs, commands with output, failures and cost.
Inside Claude Code:
/plugin marketplace add JPvanderMerwe/orbit
/plugin install orbit@orbit
Restart Claude Code, then type /orbit.
pipx install git+https://github.com/JPvanderMerwe/orbit
orbit install-hooks
orbit
orbit install-hooks connects Orbit to Claude Code by adding hooks to ~/.claude/settings.json. It backs up that file first and keeps any hooks you already have. orbit uninstall-hooks removes only Orbit's hooks. Use either the plugin or install-hooks, not both, or every action is recorded twice.
| In Claude Code | In a terminal | What it does |
|---|---|---|
/orbit |
orbit session <id> |
Open Orbit on the session you are in |
/orbit all |
orbit |
Open the start screen with every session |
/orbit chats |
orbit chats |
Open every saved conversation |
/orbit new [folder] |
orbit new [folder] |
Start a new Claude session in the workspace |
/orbit statusline |
orbit install-statusline |
Show your Pro or Max plan limits in Orbit |
/orbit statusline off |
orbit uninstall-statusline |
Put your previous status line back |
/orbit desktop |
orbit install-desktop |
Record every tool Claude Desktop uses on this computer |
/orbit desktop off |
orbit uninstall-desktop |
Undo it |
/orbit status |
orbit status |
Say whether Orbit is running |
/orbit stop |
orbit stop |
Stop Orbit (also closes workspace sessions) |
orbit install-hooks |
Connect Orbit to Claude Code without the plugin | |
orbit url |
Print the private link instead of opening a browser |
Keyboard: / search · E expand the selected step · ← → previous and next step in the full-screen view · Space play or pause a replay · Esc close or go back.
-
Estimated cost comes from the token counts Claude Code writes to its own session files, priced at Anthropic's API list prices (October 2026). It shows what the same work would cost on the API. If you're on a Pro or Max plan you aren't billed per token, so use the plan rings for your real limits.
-
Plan limits (5-hour and weekly) are only shared by Claude Code through its status line.
/orbit statuslinesets that up. If you already have a status line, Orbit keeps it: it passes the same data to yours and shows your line's output. These limits only exist on Pro and Max plans. -
Prices change. To correct or add a model, create
~/.orbit/prices.jsonlike this (US$ per million tokens: input, output, 5-minute cache write, 1-hour cache write, cache read):{ "claude-opus-5-5": [4, 20, 5, 8, 0.2] } -
Claude Code's session file format is internal and can change between versions. If a future version changes it, cost and chat history may stop updating until Orbit is updated. The live map does not depend on it.
- Claude Code
- Python 3.9 or newer (standard library only; nothing else to install)
- macOS, Linux, or Windows 10 (version 1809) or later
On Windows, Orbit runs through Git Bash, the shell Claude Code itself uses there (it comes with Git for Windows). Install Python from python.org or the Microsoft Store; Orbit finds it as py, python or python3.
- Everything stays on your computer. Orbit listens on
127.0.0.1only and sends nothing anywhere. - A workspace terminal can run commands on your computer, so Orbit is locked with a private access key stored in
~/.orbit/token, readable only by you./orbitopens it with that key. Any other request is refused, including from other user accounts on the same computer and from other websites open in your browser. - Claude Code runs unmodified and signs in through its own login. Orbit never sees or handles your Claude credentials.
- Activity is saved to
~/.orbit/events.jsonl, including file contents Claude read and command output, each value cut at 20,000 characters. The file is trimmed automatically at 50 MB. Press Clear in Orbit, or delete the folder, to wipe it. - Chats reads Claude Code's own saved conversations in
~/.claude/projectsand never changes them. - Reports include your prompts, commands and code changes. Check one before you share it.
- The hook adds about 50 milliseconds per action and can never block or break Claude.
| Environment variable | Default | Purpose |
|---|---|---|
ORBIT_PORT |
7777 |
Port for Orbit |
ORBIT_DATA |
~/.orbit |
Where activity, the access key and settings are stored |
Orbit is the new name for Activity Viewer. Uninstall the old plugin first (/plugin uninstall activity-viewer@activity-viewer), then install Orbit. Your recorded activity and access key move from ~/.claude-activity-viewer to ~/.orbit automatically the first time Orbit runs.
Claude Desktop chats. Set Orbit up once. After that, say "open Orbit" in any Claude Desktop chat and Claude opens it in your browser. Nothing opens unless you ask. Every tool Claude Desktop uses on your computer (its MCP servers) is recorded live in a session called Claude Desktop.
Setup, once. You need Python (python.org or, on Windows, the Microsoft Store).
On Windows, in PowerShell:
py -m pip install --user https://github.com/JPvanderMerwe/orbit/archive/refs/heads/main.zip
py -m orbit.cli install-desktop
(If py isn't recognised, as with Python from the Microsoft Store, type python instead of py.)
On macOS or Linux, in a terminal (pipx installs it in its own space):
pipx install https://github.com/JPvanderMerwe/orbit/archive/refs/heads/main.zip
orbit install-desktop
If you already use Orbit in Claude Code, type /orbit desktop there instead. Then quit Claude Desktop completely (on Windows, right-click its icon by the clock and choose Quit) and open it again.
The Code tab. Claude Code inside Claude Desktop is the same Claude Code, with plugins and hooks. /orbit works there once Orbit's plugin is added to it. Typed into a normal chat, /orbit isn't recognised: chats can't run commands on your computer, which is what "open Orbit" is for. Cloud, SSH and WSL sessions can't run plugins, so Orbit can't see those.
How it works: Orbit adds its own small MCP server to claude_desktop_config.json (its one tool, open_orbit, opens Orbit; Claude never sees your access key) and puts a relay in front of each of your MCP servers. It backs the file up first. The relay starts the real server and passes every message through unchanged, and also sends each tool call and result to Orbit. py -m orbit.cli uninstall-desktop on Windows (orbit uninstall-desktop on macOS and Linux, or /orbit desktop off in Claude Code) puts the file back as it was.
What Orbit can't show from Desktop chats:
- The chat itself (your messages and Claude's replies). Claude Desktop doesn't share them with other programs.
- Things Claude does on Anthropic's side: web search, the code it runs in its own sandbox, artifacts.
- Tools added through Settings > Extensions, or remote connectors (they aren't in the settings file Orbit adjusts).
Run the setup again after adding an MCP server, so Orbit records that one too. If the setup can't find Claude Desktop's settings, open them in Claude Desktop (Settings > Developer > Edit Config) and add the file's path: install-desktop --config "<path>".
Optional narration. extras/claude-desktop/mcp_server.py gives Claude a show_step tool to describe what it's doing in its own words, as steps marked "reported by Claude". It's Claude's own account, not a record. Add it to claude_desktop_config.json:
{
"mcpServers": {
"orbit": {
"command": "python3",
"args": ["/full/path/to/extras/claude-desktop/mcp_server.py"]
}
}
}On Windows, use "command": "python" (or "py") and a path like "C:/Users/you/orbit/extras/claude-desktop/mcp_server.py".
| Path | What it is |
|---|---|
.claude-plugin/marketplace.json |
Claude Code plugin marketplace catalogue |
plugins/orbit/ |
The plugin: hooks, local server, dashboard, /orbit command |
pyproject.toml |
Standalone orbit command (pip or pipx) |
extras/claude-desktop/ |
Optional MCP server for Claude Desktop |
tests/smoke.py |
End-to-end check, run on Windows, macOS and Linux for every change |
The workspace terminal uses xterm.js (MIT licence), bundled in plugins/orbit/scripts/vendor/ with its licence file.
MIT. See LICENSE.
Orbit is an independent community project. It is not made or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic.