Glassbox

Make the AI-agent black box observable. A local, read-only live view of every Claude Code session you're running — across every project on your machine.

Glassbox reads the session transcripts Claude Code already writes to ~/.claude/projects/**/*.jsonl, derives what each session is doing, and streams a live tile grid to your browser. No backend, no API keys, no model calls — it just reads files that are already on disk.

Why

If you run more than one agent at a time, you lose track of them. Glassbox gives you one pane: which sessions are running, what each just did, what files it touched, and the task it's working on.

Run

npx @theronap/glassbox

That's it — it starts a local server and auto-opens your browser to the live dashboard. Requires Node 18+ and that you use Claude Code (Glassbox reads the sessions Claude Code records locally at ~/.claude/projects/). No dependencies, nothing leaves your machine.

From a clone:

npm start           # live dashboard (auto-opens the browser)
npm run scan 6      # one-shot terminal table of sessions active in the last 6h

Always-on (hands-off)

glassbox install      # macOS login agent: autostarts on login, always at http://127.0.0.1:7330
glassbox uninstall    # remove it

Once installed it runs in the background across reboots. Open the dashboard anytime, or just run glassbox — it detects the running server and opens it instead of starting a new one.

Let your agent set it up. The audience already runs Claude Code, so the whole thing can be installed with zero clicks — point your agent at one line:

npm i -g @theronap/glassbox && glassbox install

Claude Code runs that and Glassbox is live and permanent — no config, no login, nothing for you to do.

What each tile shows

• Project + branch — from the session's cwd and git branch
• Status — running / active / waiting / idle / done (from transcript recency)
• Last action — the agent's most recent tool call (e.g. Bash: git status, Edit: parse.mjs)
• Files edited / read / events — counts across the session
• Task — the prompt the session is currently working on

How it works

• src/parse.mjs — streams one transcript and extracts rolling session state
• src/discover.mjs — finds transcripts modified in the recent window, parses them
• src/server.mjs — zero-dependency HTTP + SSE server; polls and pushes snapshots
• public/index.html — the live tile grid

Scope (v0.1)

Read-only. Acting on sessions (jump in, kill, runaway alarms) and cross-machine views are deliberately deferred to later versions.

Status

Builder-stage MVP. Not affiliated with or endorsed by Anthropic; relies on the undocumented Claude Code transcript format, which may change.