{"id":"de14d544-7f03-4369-bac7-5cdeb12c66c8","slug":"claude-sesh","kind":"mcp","name":"claude-sesh","summary":"Session explorer for Claude Code - find, search, and resume all your past sessions","owner":"abracadabra50","repoUrl":"https://github.com/abracadabra50/claude-sesh","license":"MIT","licenseTier":"permissive","trust":"community","stars":16,"match":null,"fewStars":false,"format":"mcp","createdAt":"2025-12-17T12:06:09.000Z","addedAt":"2026-10-14T05:48:11.541Z","logoUrl":"https://avatars.githubusercontent.com/u/195611275?u=d88c535f2b90d5cff50c0eac605d4d57634ad17f&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools","search","data-analytics"],"tags":["analytics","anthropic","claude-code","cli","developer-tools","typescript","session-explorer"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T07:49:26.443Z","sample":false,"url":"https://conduits.dev/tools/claude-sesh","language":"TypeScript","transports":["stdio"],"install":{"npm":"claude-sesh"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"
\n\n# ๐Ÿ—‚๏ธ claude-sesh\n\n### Your Claude Code sessions, organized.\n\n
\n\n**Claude Code buries your sessions in `~/.claude/projects/`.**\n**Good luck finding that conversation from last week.**\n\n
\n\n[![npm version](https://img.shields.io/npm/v/claude-sesh.svg?style=for-the-badge&color=D4A574)](https://www.npmjs.com/package/claude-sesh)\n[![npm downloads](https://img.shields.io/npm/dm/claude-sesh.svg?style=for-the-badge&color=8B7355)](https://www.npmjs.com/package/claude-sesh)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-enabled-D4A574.svg?style=for-the-badge)](https://modelcontextprotocol.io)\n\n
\n\n```bash\nnpx claude-sesh web\n```\n\n**One command. Zero config. Your entire Claude Code history.**\n\n
\n\n[Features](#features) ยท [Quick Start](#quick-start) ยท [Dashboard](#-web-dashboard) ยท [CLI](#-cli-commands) ยท [MCP](#-mcp-integration)\n\n
\n\n\"claude-sesh\n\n
\n\n
\n\n---\n\n
\n\n## Features\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n\n### ๐Ÿ” Session Explorer\n\n**Find any conversation instantly.**\n\nBrowse your complete Claude Code history with powerful filtering by project, date, model, and more. Never lose track of that perfect solution again.\n\n\n\n### ๐Ÿ”Ž Full-Text Search\n\n**Search across everything.**\n\nFind sessions by code snippets, error messages, or any text. Search spans all your conversations, tool calls, and outputs.\n\n
\n\n### ๐Ÿ“Š Usage Analytics\n\n**Know where your tokens go.**\n\nTrack costs, token usage, and coding time across all sessions. See breakdowns by project, model, and time period.\n\n\n\n### ๐Ÿ”„ Easy Resume\n\n**Pick up where you left off.**\n\nGet rich context summaries to continue any session. Copy resume prompts or use Claude's native resume feature.\n\n
\n\n### ๐Ÿท๏ธ AI Enrichment\n\n**Auto-generated insights.**\n\nLet AI summarize sessions, extract key decisions, and add searchable tags. Powered by your Anthropic API key.\n\n\n\n### ๐Ÿง  MCP Integration\n\n**Give Claude memory.**\n\nLet Claude search your past sessions directly. Ask \"How did I solve this before?\" and get real answers.\n\n
\n\n
\n\n---\n\n
\n\n## Quick Start\n\n\n\n\n\n\n
\n\n### โšก Try instantly\n\n```bash\nnpx claude-sesh web\n```\n\nOpens `http://localhost:3847` with your full Claude Code history.\n\n**No install. No config. No API keys.**\n\n\n\n### ๐Ÿ“ฆ Install globally\n\n```bash\nnpm install -g claude-sesh\n```\n\nThen use the CLI anywhere:\n\n```bash\nsesh list # List sessions\nsesh search \"bug\" # Search conversations\nsesh stats # View analytics\nsesh web # Launch dashboard\n```\n\n
\n\n
\n\n---\n\n
\n\n## ๐Ÿ–ฅ๏ธ Web Dashboard\n\n```bash\nsesh web\n```\n\n
\n\n\n\n\n\n\n\n\n\n\n\n\n
\n

๐Ÿ“ˆ

\nStats at a Glance
\nTotal tokens, cost, hours coded\n		\n

๐Ÿ“…

\nActivity Heatmap
\nGitHub-style contribution graph\n		\n

โฑ๏ธ

\nSession Timeline
\nVisual history of all your work\n
\n

๐Ÿ†

\nLeaderboards
\nTop projects, tools, models\n		\n

๐Ÿ”

\nDeep Search
\nFind by content, project, date\n		\n

๐Ÿ“‹

\nSession Details
\nFull context for any session\n
\n\n
\n\n---\n\n
\n\n## ๐Ÿ’ป CLI Commands\n\n\n\n\n\n\n\n\n\n\n
\n\n**Browse Sessions**\n```bash\nsesh list # Recent sessions\nsesh ls -n 50 # Last 50 sessions\nsesh show # Session details\nsesh projects # List all projects\n```\n\n\n\n**Search & Find**\n```bash\nsesh search \"auth\" # Full-text search\nsesh continue # Find resumable sessions\nsesh stats # Overall statistics\n```\n\n
\n\n**Resume Work**\n```bash\nsesh resume # Get resume context\nsesh resume --copy # Copy to clipboard\nsesh resume --native # Use Claude's resume\n```\n\n\n\n**AI Features**\n```bash\nsesh enrich # Generate AI summaries\nsesh enrich --limit 20 # Enrich 20 sessions\nsesh enrich --stats # Check progress\n```\n\n
\n\n
\n\n---\n\n
\n\n## ๐Ÿง  MCP Integration\n\n**Give Claude access to your session history.**\n\n```bash\nclaude mcp add claude-sesh --scope user -- npx claude-sesh mcp\n```\n\nRestart Claude Code. Now ask things like:\n\n> *\"What was I working on in this project?\"*\n> *\"How did I solve the caching issue before?\"*\n> *\"What files have changed recently?\"*\n\n
\n\n
\nAvailable MCP Tools\n\n
\n\n| Tool | Description |\n|------|-------------|\n| `search_sessions` | Full-text search across all sessions |\n| `get_session` | Get detailed info about a specific session |\n| `get_project_context` | Recent sessions, decisions, todos for a project |\n| `get_pending_todos` | Find incomplete tasks across sessions |\n| `search_decisions` | Find past architectural decisions |\n| `search_knowledge` | Search learnings and solutions |\n| `get_file_history` | Track changes to specific files |\n| `get_recent_activity` | Summary of recent coding activity |\n\n
\n\n
\n\n---\n\n
\n\n## ๐Ÿท๏ธ AI Enrichment\n\n**Auto-generate summaries and tags for better search.**\n\n```bash\nexport ANTHROPIC_API_KEY=your-key\nsesh enrich\n```\n\n\n\n\n\n\n\n\n
๐Ÿ“ Summary
What was accomplished		๐ŸŽฏ Decisions
Key choices made		๐Ÿ› Problems
Issues & solutions		๐Ÿท๏ธ Tags
Auto-categorization
\n\n
\n\n---\n\n
\n\n## How It Works\n\n```\nโ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”\nโ”‚ Claude Code writes sessions to ~/.claude/projects/ โ”‚\nโ”‚ โ†“ โ”‚\nโ”‚ claude-sesh parses & aggregates session data โ”‚\nโ”‚ โ€ข Token counts, costs, duration โ”‚\nโ”‚ โ€ข Tool usage breakdown โ”‚\nโ”‚ โ€ข File changes tracked โ”‚\nโ”‚ โ†“ โ”‚\nโ”‚ AI Enrichment (optional) โ”‚\nโ”‚ โ€ข Auto-generate summaries โ”‚\nโ”‚ โ€ข Extract key decisions โ”‚\nโ”‚ โ€ข Add searchable tags โ”‚\nโ”‚ โ†“ โ”‚\nโ”‚ Web Dashboard & CLI โ”‚\nโ”‚ โ€ข Search all sessions โ”‚\nโ”‚ โ€ข View analytics & trends โ”‚\nโ”‚ โ€ข Resume past work โ”‚\nโ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜\n```\n\n**Your data stays local.** claude-sesh reads Claude's existing session files. Nothing is uploaded anywhere.\n\n
\n\n---\n\n
\n\n## ๐Ÿ”’ Privacy & Security\n\n\n\n\n\n\n\n
๐Ÿ’พ
100% Local
All data stays on your machine		๐Ÿ‘€
Read-Only
Never modifies Claude's files		๐Ÿ“ก
No Telemetry
Zero data collection
\n\n
\n\n---\n\n
\n\n## Configuration\n\n
\nChange Dashboard Port\n\n```bash\nsesh web --port 8080\n```\n\n
\n\n
\nData Locations\n\nClaude Code sessions:\n```\n~/.claude/projects/[project-path]/[session-id].jsonl\n```\n\nEnriched data (optional):\n```\n~/.claude-sesh/enriched/[session-id].json\n```\n\n
\n\n
\nTroubleshooting\n\n**Dashboard not loading?**\n```bash\nlsof -i :3847 # Check if port in use\nsesh web --port 8080 # Try different port\n```\n\n**Search returning nothing?**\n- Try broader search terms\n- Run `sesh enrich` to improve searchability\n\n**MCP not working?**\n- Restart Claude Code after adding MCP server\n- Verify with `claude mcp list`\n\n
\n\n
\n\n---\n\n
\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines and our roadmap.\n\n
\n\n---\n\n
\n\n
\n\n**Built for the Claude Code community** โค๏ธ\n\n[Report Bug](https://github.com/abracadabra50/claude-sesh/issues) ยท [Request Feature](https://github.com/abracadabra50/claude-sesh/issues) ยท [Discussions](https://github.com/abracadabra50/claude-sesh/discussions)\n\n
\n\nMIT License ยท [Claude Code](https://docs.anthropic.com/en/docs/claude-code) ยท [Model Context Protocol](https://modelcontextprotocol.io)\n\n
\n"}