Skip to main content

Outside-in web observer for Claude Code sessions and callstack call trees

Project description

unwind

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

Run unwind serve in any project folder; a browser tab opens showing every Claude Code session that's run there, the conversation for each one, and — when the callstack plugin's /call skill is used — the call hierarchy between sessions and any spawned subagents.

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

Install

pip install unwind-labs

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).

Web UI

cd /path/to/your/claude-project
unwind serve

A browser tab opens at http://127.0.0.1:<port>/ with that project's sessions. Ctrl-C to stop.

unwind serve --help lists flags (custom port, --all project picker, --no-browser, etc.).

Keyboard shortcuts

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

CLI inspection

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.

  • 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.

How it works

unwind reads:

  • ~/.claude/projects/<slug>/*.jsonl — Claude Code's own session logs
  • <project>/.claude/callstack/log//call invocation reports written by the callstack plugin

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unwind_labs-0.4.0.tar.gz (307.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

unwind_labs-0.4.0-py3-none-any.whl (329.4 kB view details)

Uploaded Python 3

File details

Details for the file unwind_labs-0.4.0.tar.gz.

File metadata

  • Download URL: unwind_labs-0.4.0.tar.gz
  • Upload date:
  • Size: 307.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for unwind_labs-0.4.0.tar.gz
Algorithm Hash digest
SHA256 f234f47031c7ec2352179f83d48d30fcb9f06bfe58f0d5e399c164c61e5346dd
MD5 24a215e73b336996d5c7eb19a8866f9d
BLAKE2b-256 2bfb7c4d9cab65fa0ce5cf928d4322c706c8f10b98cd28b3c57a5f5488821ca2

See more details on using hashes here.

Provenance

The following attestation bundles were made for unwind_labs-0.4.0.tar.gz:

Publisher: publish.yaml on unwind-labs/unwind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file unwind_labs-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: unwind_labs-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 329.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for unwind_labs-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 21537d90ee59d4c2e1b110390b9e89fbfbb66ff4a0b64f8bd6334d0be58f83a5
MD5 498e607664c23e64c48e80b0a1503200
BLAKE2b-256 614c3cb6fc375871e1be9aec2e8007670ac3df703be3d6df2fb5a7dcf8eb803a

See more details on using hashes here.

Provenance

The following attestation bundles were made for unwind_labs-0.4.0-py3-none-any.whl:

Publisher: publish.yaml on unwind-labs/unwind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page