claude-live

Real-time visualization of Claude Code activity as an orbital solar system.

Try the demo (no install needed)

Install

Via Claude plugin marketplace (recommended)

claude plugin marketplace add marisancans/claude-live

Hooks are configured automatically. Events stream in the background as you work.

Via npm (manual setup)

npm install -g claude-live

Then add hooks to your ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [{ "hooks": [{ "type": "command", "command": "node /path/to/hook.js", "async": true }] }],
    "PostToolUse": [{ "hooks": [{ "type": "command", "command": "node /path/to/hook.js", "async": true }] }]
  }
}

Replace /path/to/hook.js with the result of npm root -g/claude-live/bin/hook.js.

Use

claude-live          # Start server (foreground)
claude-live start    # Start server (detached)

Then open http://localhost:43451 in your browser.

How It Works

Sessions appear as star systems. Files orbit as planets -- the more a file is touched, the larger it grows. Tool calls animate between nodes:

• Read / Grep / Glob -- scanner at the file, data streams back to core
• Edit / Write -- ink beam fires from core to file
• Bash -- terminal window appears at the node
• Subagents -- satellite systems tethered to their parent

Multiple Claude sessions show as separate star systems. Prompts fly inward, responses fly outward. Context compaction triggers an implosion/rebirth effect.

Under the hood: the plugin sends every event to a lightweight Node.js server (pure passthrough, no persistence). The server broadcasts events to a PixiJS frontend via Server-Sent Events (SSE).

CLI

claude-live start       # Open visualization in browser
claude-live stop        # Stop the server
claude-live status      # Show server status

Development

git clone https://github.com/marisancans/claude-live.git
cd claude-live
npm install

node server/index.js            # Node.js server on :43451
cd client && npm run dev        # Vite hot-reload on :7979
cd client && npx tsc --noEmit   # Type check frontend

License

MIT