resume-resume

New free tool we're dropping.

MCP Server

Add it to Claude Code and every session on your machine can search, read, and merge your full session history — in plain English.

pip install resume-resume
claude mcp add resume-resume -- resume-resume-mcp

Or manually in your MCP config:

{
  "mcpServers": {
    "resume-resume": {
      "command": "resume-resume-mcp"
    }
  }
}

We built Eidos, a multi-agent AI system. In our benchmark, Eidos outperformed Claude Opus 4.6 by 3.6x in both accuracy and speed on complex tasks with 15+ reasoning chains. Below, we use Claude Resume to pick up where we left off across multiple sessions.

Finding the benchmark where Eidos beat Claude Opus 4.6

"use resume-resume to find the eidos test where we beat claude"

Searching for a past session in plain English

"use resume-resume to find the latest chats about eidos philosophy docs"

Merging multiple past sessions into this chat

"use claude resume to merge march 14th conversations and Eidos v5 Pipeline Telemetry convo from march 11th into this chat"

Two sessions — one about eidos-philosophy doc changes (Mar 14) and one with a full 28-task strategic plan (Mar 11) — merged into the current conversation with a single command.

MCP Tools

Quick Resume — Paste & Go

claude --resume <id> fails if you're in the wrong directory. cr fixes that — paste any claude command and it auto-discovers the correct project directory, ensures the right flags are on, and launches.

cr claude --resume ddf7fc98-6c93-40c8-9444-503d8a716dbf
cr claude --resume ddf7fc98-6c93-40c8-9444-503d8a716dbf --model opus --chrome
cr ddf7fc98-6c93-40c8-9444-503d8a716dbf

What it does:

1. Parses the session ID out of whatever you pasted
2. Searches ~/.claude/projects/*/ to find which project owns that session
3. Resolves the encoded directory name back to a real filesystem path
4. Adds --dangerously-skip-permissions and --enable-auto-mode if not already present
5. Pops a macOS dialog showing the session, resolved cwd, and full command (proof it worked — visible outside the TUI)
6. cds to the correct directory and execs into Claude

No more "No conversation found" errors from being in the wrong folder.

TUI

For when your machine died and you just need to get back to work.

pip install resume-resume
resume-resume        # last 4 hours
cr 24                # last 24 hours
cr --all             # everything

Requires Python 3.11+ and Claude Code.

How It Works

1. Scans ~/.claude/projects/ for JSONL session files
2. Scans all project directories for dirty git state (parallel git status --porcelain)
3. Scores sessions by urgency: session recency (2h half-life) + repo dirty urgency (file count + dirty file recency)
4. Dirty repos bypass age filters — uncommitted work doesn't age out
5. Summarizes via claude -p with Haiku, cached permanently after first run
6. Classifies sessions as human or automated using a gradient boosting model trained on 3,800 sessions — bot sessions hidden by default
7. Surfaces bookmark data (lifecycle badges, next actions, blockers) when present
8. Reports negative space — how many repos were scanned, how many were clean vs dirty

Run /bookmark inside any Claude Code session to capture lifecycle state (done, paused, blocked, handoff) before closing. An auto-bookmark Stop hook captures minimal state when you don't.

Related

• claude-session-commons — Shared session parsing, caching, and classification used by this repo and others
• resume-resume-duet — Web UI companion with session browser and resume-resume:// URL scheme handler

License

MIT