csesh — Claude Code Session Manager

csesh is a CLI + web dashboard to navigate, search, analyze, and clean up Claude Code sessions.

Commands

List sessions

csesh list                    # latest 50 sessions
csesh list --tier 4           # only "keep" sessions
csesh list --project myapp    # filter by project
csesh list --favorites        # favorites only
csesh list --tag bugfix       # filter by tag
csesh list --sort size        # sort by: date | size | messages | tier
csesh list --junk             # tier 1+2 only

Show session details

csesh show <id>               # full detail with metadata, tokens, cost

Deep analysis

csesh analyze <id>            # single session: tool usage, thinking, files
csesh analyze                 # all sessions: summary with distributions

Search

csesh search "refactor auth"
csesh search "docker" --project myapp
csesh search "migration" --from 2025-01-01 --to 2025-06-30

Statistics

csesh stats                   # global stats
csesh stats --project myapp   # project-specific

Cleanup junk sessions

csesh cleanup --dry-run       # preview what would be trashed
csesh cleanup                 # interactive cleanup by tier
csesh cleanup --tier1-only    # 100% safe auto-delete

Resume a session

csesh resume                  # interactive session picker
csesh resume --project myapp  # filter by project
csesh resume --favorites      # only favorites
csesh resume --tag urgent     # filter by tag

Tag and title

csesh tag <id> bugfix
csesh title <id> "Auth refactor session"

Export

csesh export --format json
csesh export --format csv --output sessions.csv
csesh export --session <id>   # single session as Markdown

Web dashboard

csesh web                     # start on port 3456
csesh web --port 8080

Trash management

csesh trash list
csesh trash restore <id>
csesh trash delete <id>
csesh trash empty

Cache management

csesh cache clear
csesh cache stats

When to Suggest Each Command

• User wants to find a session: suggest csesh list with appropriate filters or csesh search
• User wants to resume work: suggest csesh resume (interactive picker that launches claude --resume)
• User wants to clean up: suggest csesh cleanup --dry-run first, then csesh cleanup
• User wants to understand usage: suggest csesh stats or csesh analyze
• User wants a visual overview: suggest csesh web
• User wants to export data: suggest csesh export with the appropriate format

Example Workflows

Clean up old sessions

csesh stats                   # see how much space is used
csesh cleanup --dry-run       # preview cleanup
csesh cleanup                 # interactive cleanup

Find and resume a session

csesh search "auth refactor"  # find it
csesh resume --project myapp  # or browse and pick

Analyze usage patterns

csesh stats                   # overview
csesh analyze                 # deep analysis across all sessions
csesh web                     # visual dashboard with charts

Installation

npx @arthurpcd/csesh --help              # run directly
npm install -g @arthurpcd/csesh          # or install globally