cc — Claude Code Session Manager

A CLI tool for managing Claude Code sessions. Browse, search, tag, export and resume your sessions from the terminal.

Install

npm install -g cc-session-manager

Usage

Interactive session picker

cc

Arrow keys to select, Enter to resume.

Commands

cc list                          # List all sessions
cc list --since 7d               # Last 7 days
cc list --project myapp          # Filter by project
cc list --tag debug              # Filter by tag
cc search "keyword"              # Full-text search
cc tag <id> <tag>                # Add tag
cc tag <id> <tag> --remove       # Remove tag
cc export <id>                   # Export as Markdown
cc export <id> --format json     # Export as JSON
cc export <id> -o output.md      # Export to file
cc stats                         # Usage statistics
cc resume <id>                   # Resume session
cc rm <id>                       # Delete session
cc rm <id> --force               # Delete without confirmation

Session IDs support UUID prefix matching (>=4 chars) and slug matching.

How it works

Reads session data directly from ~/.claude/projects/ JSONL files. Tags are stored in ~/.claude/cc-metadata.json. Does not modify any Claude Code internal files.

License

MIT