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