🗂️ 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

💻 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?"

| 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

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

Configuration

sesh web --port 8080

Claude Code sessions:

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

Enriched data (optional):

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

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