@synapse-ai/cli
v0.1.3
Published
Real-time agent observability for Claude Code. See what your AI agents are actually doing.
Maintainers
Readme
Synapse
See what your AI agents are actually doing.
Real-time agent observability for Claude Code. Every session, agent, subagent, and tool call rendered as a live, interactive node graph.
For developers running Claude Code who want to see what's happening under the hood.
Install
npm install -g @synapse-ai/cliRequires Node.js 20+.
Quick Start
cd ~/your-project
synapse startServer starts, hooks configured, browser opens. Run Claude Code like normal. Everything streams to the graph in real-time.
Don't want to install globally? npx @synapse-ai/cli start works too.
Features
- Live node graph — Sessions, agents, subagents, and tool calls as connected nodes with animated edges. Color-coded by status, auto-expanding as agents spawn.
- Four analysis lenses — Tree view, treemap, sankey flow, and compaction timeline. Click a node in any lens — it highlights in the graph.
- Tool call grouping — 47 tool calls don't produce 47 nodes. Three display modes: pill grid, timeline swimlanes, frequency matrix.
- Remote approval — Start a job, walk away, approve permissions from your phone. Requires
--lanmode. - Keyboard navigation — Arrow keys to walk the graph. Up/down the spine, left/right between siblings. Navigate a 200-node tree without touching the mouse.
- Node inspector — Click any node for full metadata: tool arguments, response payloads, token counts, timing, parent chain.
- Mobile UI — Full responsive layout. Remote approval works from your phone's browser.
Commands
| Command | What it does |
| ------------------ | ------------------------------------------ |
| synapse start | Start server (Ctrl+C to stop) |
| synapse start -d | Start as background daemon |
| synapse stop | Stop the server |
| synapse status | Show URL, PID, and hook status |
| synapse open | Open dashboard in your browser |
| synapse hook | Hook current project to the running server |
| synapse unhook | Remove hooks from current project |
| synapse help | Show all options |
Start Options
synapse start -d # Background daemon (recommended)
synapse start --lan # LAN-accessible (mobile approval)
synapse start --observe-only # Monitor only — no permission interception
synapse start --port 9000 # Custom port
synapse start --no-open # Don't open browser
synapse start --no-hook # Server only, no hook configurationMulti-Project Setup
The server is global — start it once, then hook as many projects as you want:
synapse start -d # Start once
cd ~/project-a && synapse hook # Hook project A
cd ~/project-b && synapse hook # Hook project B
synapse open # Dashboard shows everythingSecurity
By default, the server binds to localhost only. Nothing leaves your machine.
Pass --lan to enable remote approval from other devices on your network. This opens unauthenticated HTTP endpoints — anyone on your Wi-Fi can see and respond to permission requests.
Use --observe-only for pure read-only monitoring. The permission hook doesn't even start. All visualization, no attack surface.
Troubleshooting
Claude Code hangs on every prompt:
The server is not running but hooks are still configured. Either start the server (synapse start -d) or remove the hooks (synapse unhook).
Events not appearing:
Run synapse status to check hook status. Re-run synapse hook if needed.
Port already in use:
synapse start --port 9000 — pick a different one.
Demo
60-second walkthrough: Watch on YouTube
Links
License
MIT
Built with Claude.The ideas were mine. The 38,000 lines of code were not.Thanks to Anthropic for turning "what if" into "what is."
