swyxio

swyxio / claude-compaction-viewer

Public

A TUI and CLI tool for inspecting Claude Code conversation history and compaction events.

39
1
100% credibility
Found Mar 06, 2026 at 39 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A desktop tool that lets users browse and analyze conversation logs from Claude Code sessions, highlighting moments where the AI condenses long histories into summaries.

How It Works

1
🤔 Curious about long AI chats

You've been working on coding projects with your AI helper Claude Code, and wonder how it manages super long conversations without losing track.

2
📥 Pick up the viewer tool

Grab this handy viewer app for your computer – it installs quickly and easily.

3
🔍 Scan your project folders

Check all your saved chat histories at once to see which ones got special summaries to keep things short.

4
📱 Dive into the full view

Launch the colorful screen that shows your entire chat like a storybook, with highlights on key summary moments.

5
🔄 Explore messages and summaries

Scroll through messages, jump to summary spots with a key press, and read exactly what the AI kept or shortened.

✅ Master your chat histories

You now clearly see how your long AI coding sessions were smartly summarized, helping you understand and improve future chats.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 39 to 39 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-compaction-viewer?

This Python TUI and CLI tool scans your Claude Code conversation logs in ~/.claude/projects/ to reveal compaction events, where Claude summarizes bloated context windows to keep sessions running. Run `ccv --scan` for a quick table of projects, sessions, token counts, and compaction counts, or `ccv --summary file.jsonl` to dump full summaries. Launch `ccv` for an interactive terminal UI with a project tree, stats bar, message list, and detail viewer—perfect for spotting where Claude trimmed history.

Why is it gaining traction?

In the awesome TUI GitHub ecosystem of tui cli gui apps like github tui apps and github tui terminal tools, it stands out with dead-simple install via uv or pip, plus keybindings to jump compaction boundaries (c/C), toggle progress msgs (t), or show summaries (s). Developers love auditing long Claude sessions without parsing JSONL manually—token stats, triggers (auto or /compact), and full summaries appear instantly, saving hours of brain surgery on AI convos.

Who should use this?

Claude Code power users debugging "forgetful" agents in multi-hour projects, AI prompt engineers analyzing context loss, or Anthropic API tinkerers reverse-engineering compaction triggers. Ideal for devs with sprawling ~/.claude dirs who need a github tui client to navigate sessions without VS Code.

Verdict

Grab it if you're deep into Claude—solid docs and Textual-powered TUI make it instantly useful despite 39 stars and 1.0% credibility score signaling early alpha maturity. Test on your logs before production reliance.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.