claudeers.
// Developer Tools

skyborne

A live 3D sky city of your Claude Code agents. Local-only.

// Developer Tools[ cli ][ api ][ desktop ][ web ][ claude ]#claude#agents#claude-code#developer-tools#threejs#visualization#devtools◷ Apache-2.0$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit 9 days ago
last release 9 days ago
releases 4
open issues 3
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up skyborne (claude-plugin project) into my current project.
Found on https://claudeers.com/skyborne
Repo: https://github.com/ishraq21/skyborne
Homepage/docs: https://skyborne.dev
Detected install method: claude-plugin → /plugin install skyborne@ishraq21/skyborne
Category: devtools. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add ishraq21/skyborne
/plugin install skyborne@ishraq21/skyborne
// or clone
git clone https://github.com/ishraq21/skyborne

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseApache-2.0
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

The Skybot logo

Skyborne

A Skybot asks to run a command, the beam to City Hall turns green when it is approved, and the camera pulls back over the city

Watch your Claude Code agents work, live, in a 3D sky city. Each session is a floating district and each agent is a little robot, a Skybot. See at a glance who's working, who's stuck and who needs you, and approve or deny their requests right from the city.

Everything stays on your computer: no account, no cloud, and no telemetry (nothing is sent back to anyone).

Try it in your browser: skyborne.dev. It plays a recorded session in the city, so there is nothing to install.

Status: early.

The Skyborne city at dusk: floating districts around City Hall, a Needs you card asking to approve a command, and the console listing every session

The same city in the morningThe same city at night
MorningNight

Why Skyborne?

Claude Code can run several sessions at once, and each can launch helper agents. From the terminal, it's hard to tell what they're all doing. Skyborne puts them in one place:

  • See everything at once: which sessions are working, which are idle and which are waiting for you.
  • Answer from one place: approve or deny permission requests without hunting through terminals.
  • Know where time and tokens go: how long each step took and how many tokens (the units Claude's usage is counted in) each agent used.
  • Look back: open any of your 60 most recent sessions and walk through it step by step, even ones from past days.

Features

The city

Skyborne turns your Claude Code sessions into a living city in the sky.

  • A district per session: each session is a floating island around City Hall, named after its project folder or a name you give it. Its tower grows a floor as the session uses more tokens.
  • Live, as it happens: the city changes the moment Claude Code does something. A quiet district dozes off after 3 minutes and wakes up when its session does.
  • "Needs you" alerts: when Claude asks permission, a banner at the top says who is asking, and Show me takes you to that Skybot. Desktop alerts can tell you even when the city isn't in front (off by default).
  • Morning, dusk and night: the sky follows your clock, or press T to pick a time. Hover cars, a monorail and a blimp keep the sky busy, with sound effects on M.
  • Reel mode and Safe to film: a portrait, phone-shaped view (9:16) for recording videos, and a switch that hides your prompts, files and project names.
  • History: sessions are kept for 30 days, and the first run offers to bring in the last 7 days.

Skybots

Every agent is a Skybot: a small robot that acts out what its agent is doing, so you can read the city at a glance.

  • One per agent: each session's lead, plus one for every helper it launches.
  • Homes for helpers: each district has a row of six cottages. A helper steps out of its own front door when it starts (the lead waves hello if it's free), crosses the road at the zebra crossing, where cars stop for it, and walks home when it finishes. Its window lights while it's in. When all six houses are taken, a new helper beams down by the pad instead, and beams back up shortly after it finishes.
  • Their own names: every Skybot gets a name, like Gumdrop or Onyx, and helpers show their role, like Explore or Plan.
  • Props for the job: a book while reading, a magnifying glass while searching, orbiting lights while thinking, a spinning gear while using a tool.
  • Eyes that show status: cyan while working, amber while waiting for you, red after an error, dim when asleep.
  • Moods: in the zone after a few minutes of work, tired after 20 minutes, grumpy after repeated errors, bored when idle for a while, proud when they finish.
  • Moments: when a lead finishes answering you, it does a victory dance in a burst of confetti and the free Skybots around it clap along. In quiet moments they wave to each other, stretch, yawn and take coffee breaks.
  • Asking for you: a Skybot waiting for your approval shows an amber beam linked to City Hall, which turns green when you approve and red when you deny.
  • Click one to see that agent's own steps, timeline and tokens.

The console

The panel beside the city (C or the first icon in the top-right toolbar shows or hides it; the × in its header hides it) is where you read the details and act.

  • At a glance: how many requests need you, how many Skybots are working, Usage (how much of your 5-hour limit you've used on a Pro or Max plan; on other plans, what today's sessions would cost at API prices) and Context (how close the fullest session is to filling Claude's working memory). Hover Usage to see where the tokens went, by session and by agent.
  • "Needs you" cards: each request shows the exact command, file or address and how long it has waited, with Approve (A) and Deny (D).
  • Sessions: every live session, with what needs you first, then errors, then anything slow. Filter by state (working, needs you, idle, asleep), search by name or folder, bring back past sessions, and rename a district.
  • Session detail: click a session for a timeline of every step (how long each took, agent by agent), the conversation, the files changed, every approval and the tokens per agent. Click a step for its full input and output.
  • Logs: every session's newest steps in one list, filtered by kind (prompts, tools, errors, replies, helpers) or by session, with how long each step took.
  • Settings: your name on City Hall, how long a session counts as live, desktop alerts, time of day, Safe to film, sound, sample districts and playing a recording.

Getting started

What you need

  • Python 3.11 or newer (uv, below, gets one for you if you don't have it)
  • Claude Code
  • curl (already on macOS, Windows 10 or newer and most Linux systems; skyborne doctor checks)
  • A current browser: Chrome, Edge, Firefox or Safari

Install

Skyborne installs with uv, a fast installer for Python programs. If you don't have uv yet, install it first (then open a new terminal):

curl -LsSf https://astral.sh/uv/install.sh | sh                               # macOS or Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows

(brew install uv and winget install --id=astral-sh.uv -e work too.) Then:

uv tool install skyborne
skyborne install

uv tool install puts Skyborne in a private Python environment of its own and the skyborne command on your PATH (if the command isn't found, run uv tool update-shell and open a new terminal). skyborne install then adds Skyborne's plugin to Claude Code. That asks whether to add Skyborne's status line (the info line at the bottom of Claude Code); say yes to see Usage and Context in the city. Use uv tool install as shown, not uvx: the status line remembers where Skyborne's Python lives, and uvx keeps it in a cache that gets cleaned out.

Installed from a clone of this repository before? Run skyborne uninstall there first (as .venv/bin/skyborne uninstall), then follow the steps above.

Run

skyborne

The city opens at http://127.0.0.1:7317. Start Claude Code in another terminal and its session appears as a new district. Sessions that were already open before you installed don't show up, so start a new one.

Update

Stop Skyborne first (Ctrl+C in its terminal), then:

uv tool upgrade skyborne
skyborne install

The second command makes the plugin match the new version (skyborne doctor tells you when it's needed). If you run Skyborne on another port, add it: skyborne install --port 7400. Start Skyborne again afterwards.

Commands

CommandWhat it does
skyborneStarts Skyborne and opens the city
skyborne --versionPrints the installed Skyborne version and exits
skyborne import --days 7Brings in past sessions from the history Claude Code keeps
skyborne doctorChecks your setup and explains any problem
skyborne record <id> --out demo.json --stand-insSaves one session to a file the city can replay, with personal details scrubbed; read the text it lists before you share it
skyborne uninstallRemoves the plugin and puts your old status line back

To remove Skyborne, run skyborne uninstall, then uv tool uninstall skyborne. Your history (prompts, replies and tool calls, see Privacy) stays in ~/.skyborne: delete that folder too if you want it gone, after skyborne uninstall, which needs what is in it.

Keyboard shortcuts

KeyAction
RReel mode (9:16, for filming)
SSafe to film (hides prompts, files and project names)
TTime of day
MSound
CConsole
FFull screen
A / DApprove or deny the "Needs you" card in focus
↑ ↓ Enter EscIn the console: move through a list, open, go back

Approving from the city

When Claude Code asks permission to run something, a Needs you card shows what it wants to do. Click Approve or Deny. The terminal's own prompt still works at the same time, and whichever you answer first wins.

  • Skyborne never answers on its own. If nobody answers in the city within 10 minutes, it leaves the request to the terminal.
  • Questions Claude asks you, and plans waiting for your OK, are answered in the terminal.
  • Every answer is logged: what was asked, the answer, and where it was given.

Privacy

Skyborne runs only on your computer. It listens on 127.0.0.1 (reachable from your machine only), makes no requests to the internet and sends nothing back to anyone. The 3D engine and fonts come bundled.

It keeps what Claude Code reports, including your prompts, Claude's replies and every tool call, in ~/.skyborne/skyborne.db, in a folder only your account can open. Session data older than 30 days is deleted. While Skyborne runs, other programs on this computer can reach it too, so don't run it on a computer you share with people you don't trust. See SECURITY.md.

If Skyborne isn't running, Claude Code works as usual: nothing waits or breaks (Skyborne's status line, if you added it, still shows).

Platforms

Tested end to end on macOS. The automated tests also pass on Linux and Windows, but Skyborne hasn't been tried there with real Claude Code sessions yet. Details are in the guide.

Learn more

The guide covers the rest: every view in the console, approval details, recordings, settings, what is stored and known issues.

Development

git clone https://github.com/ishraq21/skyborne.git
cd skyborne
python3 -m venv .venv                             # on Windows, use `python` and `.venv\Scripts\` in place of `python3` and `.venv/bin/`
.venv/bin/pip install -e '.[dev]'
.venv/bin/python -m pytest                        # unit tests, reducer evals, server, import, scrub and record tests
SKYBORNE_LIVE=1 .venv/bin/python -m pytest tests/live -s   # drives real Claude Code sessions (macOS/Linux)

cd page
npm ci && npx playwright install chromium         # once: three.js, the fonts and the test browser (Node 24)
node build.js                                     # builds the city into skyborne/web/ and dist/preview.html (commit both)
node dev/serve.js                                 # a preview with a fake city at http://127.0.0.1:8000/
node dev/icons.js                                 # remakes the tab icon's PNGs after a change to src/icons/icon.svg
node tests/smoke.js && node tests/live-smoke.js   # browser tests: the preview, then the real server
node build.js --site && node tests/site-smoke.js  # the demo site (page/site, not committed) and its test

This runs your checkout, not a version installed with uv: use .venv/bin/skyborne install and .venv/bin/skyborne for it.

Contributing

Contributions are welcome. Skyborne is for Claude Code only, runs only on your computer and has no telemetry, so please read CONTRIBUTING.md before you start. Please follow the Code of Conduct, and report security problems privately, as SECURITY.md describes.

Author

Created by Mirza Ishraq. Blog: my-space.io · X: @myspaceio

License

Apache License 2.0. See NOTICE and TRADEMARK.md.

Skyborne and the Skybot logo are trademarks of Mirza Ishraq Yeahia. Forks must use a different name and logo.

Skyborne is an independent project. It is not made, endorsed or supported by Anthropic. Claude and Claude Code are trademarks of Anthropic, PBC.

// faq

What is skyborne?

A live 3D sky city of your Claude Code agents. Local-only.. It is open-source on GitHub.

Is skyborne free to use?

skyborne is open-source under the Apache-2.0 license, so it is free to use.

What category does skyborne belong to?

skyborne is listed under devtools in the Claudeers registry of Claude-compatible tools.

14 views
★ 20 stars
unclaimed
updated about 1 month ago

// embed badge

skyborne on Claudeers
[![Claudeers](https://claudeers.com/api/badge/skyborne.svg)](https://claudeers.com/skyborne)

// retro hit counter

skyborne hit counter
[![Hits](https://claudeers.com/api/counter/skyborne.svg)](https://claudeers.com/skyborne)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 307,864◷ MIT[ claude ]
🔓

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 187,728◷ MIT[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// devtoolssafishamsi/⟨Python⟩★ 147,800◷ MIT[ claude ]
🔓

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 140,465◷ MIT[ claude ]
→ see how skyborne connects across the ecosystem