🗂️ claude-sesh

Your Claude Code sessions, organized.

Claude Code buries your sessions in ~/.claude/projects/.
Good luck finding that conversation from last week.

npx claude-sesh web

One command. Zero config. Your entire Claude Code history.

Features · Quick Start · Dashboard · CLI · MCP

Features

🔍 Session Explorer

Find any conversation instantly.

Browse your complete Claude Code history with powerful filtering by project, date, model, and more. Never lose track of that perfect solution again.

🔎 Full-Text Search

Search across everything.

Find sessions by code snippets, error messages, or any text. Search spans all your conversations, tool calls, and outputs.

📊 Usage Analytics

Know where your tokens go.

Track costs, token usage, and coding time across all sessions. See breakdowns by project, model, and time period.

🔄 Easy Resume

Pick up where you left off.

Get rich context summaries to continue any session. Copy resume prompts or use Claude's native resume feature.

🏷️ AI Enrichment

Auto-generated insights.

Let AI summarize sessions, extract key decisions, and add searchable tags. Powered by your Anthropic API key.

🧠 MCP Integration

Give Claude memory.

Let Claude search your past sessions directly. Ask "How did I solve this before?" and get real answers.

Quick Start

⚡ Try instantly

npx claude-sesh web

Opens http://localhost:3847 with your full Claude Code history.

No install. No config. No API keys.

📦 Install globally

npm install -g claude-sesh

Then use the CLI anywhere:

sesh list          # List sessions
sesh search "bug"  # Search conversations
sesh stats         # View analytics
sesh web           # Launch dashboard

🖥️ Web Dashboard

sesh web

📈 Stats at a Glance _{Total tokens, cost, hours coded}	📅 Activity Heatmap _{GitHub-style contribution graph}	⏱️ Session Timeline _{Visual history of all your work}
🏆 Leaderboards _{Top projects, tools, models}	🔍 Deep Search _{Find by content, project, date}	📋 Session Details _{Full context for any session}

💻 CLI Commands

Browse Sessions

sesh list              # Recent sessions
sesh ls -n 50          # Last 50 sessions
sesh show <id>         # Session details
sesh projects          # List all projects

Search & Find

sesh search "auth"     # Full-text search
sesh continue          # Find resumable sessions
sesh stats             # Overall statistics

Resume Work

sesh resume <id>           # Get resume context
sesh resume <id> --copy    # Copy to clipboard
sesh resume <id> --native  # Use Claude's resume

AI Features

sesh enrich            # Generate AI summaries
sesh enrich --limit 20 # Enrich 20 sessions
sesh enrich --stats    # Check progress

🧠 MCP Integration

Give Claude access to your session history.

claude mcp add claude-sesh --scope user -- npx claude-sesh mcp

Restart Claude Code. Now ask things like:

"What was I working on in this project?"
"How did I solve the caching issue before?"
"What files have changed recently?"

Available MCP Tools

Tool	Description
`search_sessions`	Full-text search across all sessions
`get_session`	Get detailed info about a specific session
`get_project_context`	Recent sessions, decisions, todos for a project
`get_pending_todos`	Find incomplete tasks across sessions
`search_decisions`	Find past architectural decisions
`search_knowledge`	Search learnings and solutions
`get_file_history`	Track changes to specific files
`get_recent_activity`	Summary of recent coding activity

🏷️ AI Enrichment

Auto-generate summaries and tags for better search.

export ANTHROPIC_API_KEY=your-key
sesh enrich

📝 Summary
_{What was accomplished}

🎯 Decisions
_{Key choices made}

🐛 Problems
_{Issues & solutions}

🏷️ Tags
_{Auto-categorization}

How It Works

┌────────────────────────────────────────────────────────────────┐
│  Claude Code writes sessions to ~/.claude/projects/           │
│  ↓                                                             │
│  claude-sesh parses & aggregates session data                  │
│  • Token counts, costs, duration                               │
│  • Tool usage breakdown                                        │
│  • File changes tracked                                        │
│  ↓                                                             │
│  AI Enrichment (optional)                                      │
│  • Auto-generate summaries                                     │
│  • Extract key decisions                                       │
│  • Add searchable tags                                         │
│  ↓                                                             │
│  Web Dashboard & CLI                                           │
│  • Search all sessions                                         │
│  • View analytics & trends                                     │
│  • Resume past work                                            │
└────────────────────────────────────────────────────────────────┘

Your data stays local. claude-sesh reads Claude's existing session files. Nothing is uploaded anywhere.

🔒 Privacy & Security

💾
100% Local
_{All data stays on your machine}

👀
Read-Only
_{Never modifies Claude's files}

📡
No Telemetry
_{Zero data collection}

Configuration

Change Dashboard Port

sesh web --port 8080

Data Locations

Claude Code sessions:

~/.claude/projects/[project-path]/[session-id].jsonl

Enriched data (optional):

~/.claude-sesh/enriched/[session-id].json

Troubleshooting

Dashboard not loading?

lsof -i :3847        # Check if port in use
sesh web --port 8080 # Try different port

Search returning nothing?

Try broader search terms
Run sesh enrich to improve searchability

MCP not working?

Restart Claude Code after adding MCP server
Verify with claude mcp list

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines and our roadmap.

Built for the Claude Code community ❤️

Report Bug · Request Feature · Discussions

MIT License · Claude Code · Model Context Protocol

🗂️ claude-sesh

Your Claude Code sessions, organized.

Features

🔍 Session Explorer

🔎 Full-Text Search

📊 Usage Analytics

🔄 Easy Resume

🏷️ AI Enrichment

🧠 MCP Integration

Quick Start

⚡ Try instantly

📦 Install globally

🖥️ Web Dashboard

📈

📅

⏱️

🏆

🔍

📋

💻 CLI Commands

🧠 MCP Integration

🏷️ AI Enrichment

How It Works

🔒 Privacy & Security

Configuration

Contributing

Reviews (0)