Skip to content

unwind-labs/unwind

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

132 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

unwind

See all you Claude Code sessions, where your budget went, which subagent is stuck, and how a multi-agent run actually branched.

unwind - Inspect Claude Code sessions, callstack call trees, and subagents.

unwind reads Claude Code's own session logs and renders every session as a call tree — including subagents and forked/fresh /call invocations from the callstack plugin. No instrumentation, no plugin, no startup hook. Point it at a project that's been running for months and the whole history is there.

Try it

pip install unwind-labs
cd /path/to/your/claude-project
unwind serve            # opens a browser at http://127.0.0.1:<port>

Ctrl-C to stop. unwind serve --help for flags (custom port, --all project picker, --no-browser).

What unwind is not

  • Not a profiler or APM. No live instrumentation, no hooks.
  • Everything stays local. Does not send data anywhere.
  • Doesn't modify Claude Code.

How it works

unwind reads two sources, both already on your machine:

  • ~/.claude/projects/<slug>/*.jsonl — Claude Code's own session logs (source of truth for conversations, tool calls, and token usage).
  • <project>/.claude/callstack/log//call invocation reports written by the callstack plugin (source of truth for nested /call trees).

It joins these into a unified call tree, prices each turn at the model that produced it, and serves the result over a local HTTP port.

The whole multi-agent run as one tree. Subagents, /call with forked context, and /call with fresh context — nested to any depth. Click any node to read the conversation it had, including thinking blocks.
Live status across the tree. Session cards light up on the agent currently working; anything paused waiting on you turns amber back to the root. Glance to know if it's stuck or just busy.
Cost on every session card. USD spent on each session and on its whole subtree, priced per turn at the model that produced it. When a run blows the budget, point at the branch that did it.
Cross-project monthly rollup. unwind usage report --month 2026-05 (or the Reports view) totals tokens + USD across every project. Answer "am I going to overshoot my month?" in one command.
Zoom into every session. Investigate any agent session quickly, including those stuck or errored out.

CLI

The same data the web UI shows is also available from the CLI. Run any of them with --help for full options; most accept --json for scripting.

Command Subcommands
unwind project list, show, current, path — discover known projects and resolve slugs
unwind session list, show, tree — list sessions in a project, inspect one, or render its call/subagent tree
unwind messages dump, grep — dump a session's normalized messages (text/json/markdown) or grep them
unwind task tree, list, roots, forks — explore the unified call+subagent tree, top-level roots, and in-flight forks

Let Claude Code introspect its own runs

Because every command speaks --json, Claude Code can call unwind as a tool against its own logs. Ask it things like "use unwind CLI to summarize what the last subagent did," "which branch of yesterday's session cost the most, use unwind CLI" or "find the earlier turn where we solved this same bug" — and let it unwind messages grep / unwind task tree --json its way to the answer instead of replaying from memory.

Keyboard shortcuts

  • / — switch between panes
  • / — select a session or call-tree node
  • Enter — open the selected node's details
  • Esc — close details

Optional dependencies

Canvas PNG export uses ImageMagick to stitch large trees. If magick isn't on PATH, single-tile exports still work; only oversized trees (a single dimension above ~16k px) require it. Install with brew install imagemagick (macOS) or apt-get install imagemagick (Debian/Ubuntu).

License

MIT

About

unwind - Web app and CLI to inspect Claude Code sessions, callstack call trees, and subagents. Comprehensive usage report.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors