mcp server

claude-sesh

Session explorer for Claude Code - find, search, and resume all your past sessions

abracadabra50/claude-seshcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "claude-sesh": {
      "command": "npx",
      "args": [
        "-y",
        "claude-sesh"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 17, 2026

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