Personal Claude Code session browser, fork-from-message tool, and history navigator.
Project description
cctree
Personal Claude Code session browser, fork-from-message tool, and history navigator.
Status
Phase 0: scaffolded. Implementation pending /plan-eng-review.
What it does
cctree reads your existing Claude Code session JSONL files in ~/.claude/projects/ and gives you what the built-in TUI doesn't:
- Browse all sessions across all projects, including ones the resume picker hides (50-cap, custom-titled, etc.)
- Read pre-compaction history that the TUI stops showing after
/compact(the data is in the JSONL — we just render it) - Hierarchical navigation of tool calls and subagent transcripts (collapsible, drillable)
- Task evolution scrubbing — watch your task list change over the course of a session
- Fork from any message — not just the session HEAD like
claude --fork-session— start a fresh Claude Code session from any historical point in any conversation - Search across all sessions by keyword/phrase
- Tags, stars, custom names in a local SQLite metadata layer
Phase 1 ships a CLI. Phase 2 adds a Textual TUI sharing the same core.
Why
The Claude Code TUI access layer has gaps tracked in #27242 and related issues. The data layer is intact — JSONLs are append-only and crash-safe — but the TUI doesn't expose it. cctree is the missing reading lamp.
See docs/ceo-plan.md for the full strategic plan and rationale.
Install
pipx install -e ~/projects/cctree
Layout
cctree/
├── pyproject.toml
├── README.md
├── cctree/
│ ├── __init__.py
│ ├── core/ # JSONL parser, model, tree, forge, tasks, search, export
│ ├── cli/ # Phase 1 — Click-based subcommands
│ └── storage/ # SQLite metadata layer
├── tests/
└── docs/
└── ceo-plan.md # Full CEO plan from /plan-ceo-review
License
Personal use.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cctree-0.3.0.tar.gz.
File metadata
- Download URL: cctree-0.3.0.tar.gz
- Upload date:
- Size: 164.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2e303191063677231c1edf0e94dd20df6650db1ed406208832dff6691c68413c
|
|
| MD5 |
8c26c7a9e23e3b868f8bf22c0305bfec
|
|
| BLAKE2b-256 |
89001433141413bdb2926d370dc3b88999f683651924d8c6547c5dbb33ab4092
|
File details
Details for the file cctree-0.3.0-py3-none-any.whl.
File metadata
- Download URL: cctree-0.3.0-py3-none-any.whl
- Upload date:
- Size: 62.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e5496d24fe5a88337e45a640df6a47dd487c9b0536b5dc4dc7749447bddf599a
|
|
| MD5 |
2a56733397c2514a5da004ab8cac3e66
|
|
| BLAKE2b-256 |
ddbb5684d554c5929f8dc5c718e6d6de86832c0242ee8e17039058fac2c8c9ee
|
