resume-resume

What it does

Claude Code sessions crash. Context is lost. Work has to be re-explained. resume-resume captures session state so that when a session dies, the next one picks up where the last left off — with full context of what was being worked on, what was decided, and what's next.

For developers managing many repos, resume-resume also provides a standing inventory of every repo with uncommitted changes — your dirty repos list. It only shrinks by committing.

Key features

• Dirty repos — see every repo with uncommitted changes across your machine, scored by urgency (file count + recency)
• Crash recovery — boot_up finds interrupted sessions AND scans all repos for dirty git state, with ready-to-paste resume commands
• Context recovery — boot the next session with full prior context
• Session search — BM25 full-text search across 5,000+ sessions in ~3 seconds
• Session analytics — timeline, insights, data science on your work patterns
• MCP server — agents read and write session state through tool calls

Install

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

Usage

# CLI — find recent sessions
resume-resume          # last 4 hours
cr 24                  # last 24 hours
cr --all               # everything

# MCP — from an agent
dirty_repos                                          # what needs committing?
boot_up          hours: 24                           # what crashed?
search_sessions  query: "eidos test where we beat claude"
merge_context    id: "session-123" mode: "hybrid"

Parallel git status scans across 50+ repos. BM25 search across thousands of sessions. Dirty repos bypass time filters — uncommitted work doesn't age out. Summaries cached permanently after first generation.