cc-session-utils 0.1.0

Terminal UI for managing Claude Code sessions, projects, and data

cc-session-utils

Terminal UI for Managing Claude Code Sessions

Dashboard · Session cleanup · Migration · Backup/Restore — all in your terminal

한국어

---

Demo

---

Why?

The more you use Claude Code, the more files pile up in ~/.claude — session data, cost logs, debug files, file history snapshots. It becomes hard to track which projects cost how much, or which files are orphaned and safe to clean up.

cc-session-utils gives you a visual dashboard right in your terminal to manage all of it.

---

Features

📊 Dashboard

• Total cost and per-model (Opus / Sonnet / Haiku) token/cost breakdown
• Daily / weekly / monthly usage table
• Project cost Top 10 bar chart
• Data overview: sessions, file history, debug/todo files, disk usage

📁 Project Management

• Tree view of all projects from .claude.json
• Expand to see sessions, click to preview conversations
• Trash sessions, remove projects from config
• Detect and bulk-clean orphaned sessions
• --path option to filter to a specific project

📋 File History

• Manage Claude's file version snapshots
• Detect and bulk-clean orphaned entries

🐛 Debug / Todos

• Manage debug logs and todo memos with preview panel
• Bulk-clean empty and orphaned files

🔄 Session Migration

• Copy sessions between projects (originals preserved)
• Per-session selection: Space to check/uncheck, Enter to preview conversation
• Append or Overwrite mode
• Path references auto-updated after migration

💾 Backup / Restore

• Config backup (.claude.json) or full backup (~/.claude)
• Auto safety-backup before restore
• Restore failure auto-rollback

🔒 Safety

• Symlink rejection — refuses to operate on symbolic links
• Path validation — is_relative_to allowlist blocks outside ~/.claude
• Thread-safe trash log — ~/.cc-tui/trash-log.jsonl
• Safe deletion — everything via send2trash, no permanent deletes
• Atomic config writes — tempfile + os.replace

---

Install

pip install cc-session-utils

Other methods

# uv
uv tool install cc-session-utils

# From source
git clone https://github.com/Bae-ChangHyun/cc-session-utils.git
cd cc-session-utils
uv sync && uv run cc-tui

---

Usage

cc-tui                          # Launch
cc-tui --path /your/project     # Filter to project
cc-tui --lang ko                # Korean UI

Keyboard Shortcuts

Key	Action
F1–F6	Switch tabs
q	Quit
r	Refresh all
d / D	Trash selected / all orphaned
Space	Toggle selection
Enter	Preview conversation (Migrate)

---

Data Paths

Path	Description
~/.claude.json	Project list, costs, model usage
~/.claude/projects/	Session JSONL files
~/.claude/file-history/	File version snapshots
~/.claude/debug/	Debug logs
~/.claude/todos/	Todo memos
~/.cc-tui/backups/	Backups
~/.cc-tui/trash-log.jsonl	Deletion audit log

---

Tech Stack

Python 3.11+ · Textual · Rich · send2trash · claude-agent-sdk

---

License

MIT

Made with Claude Code