Agent Tool

resume-resume

Post-crash Claude Code session recovery. Context survives the crash.

pip install resume-resume

View on GitHub 232 downloads/mo v0.5.5 Apr 17, 2026

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.

Boot and resume

Claude Code sessions die. The terminal crashes, the laptop sleeps, the model hiccups. The context is gone; the next session starts from zero and the work has to be re-explained from scratch. Resume-resume treats sessions as durable artifacts — indexed on disk, searchable, restorable — so the next boot picks up where the last one left off.

1. New morning, fresh session — boot_up surfaces what's pending

agent · fresh boot

  › boot_up hours=24  dirty repos 3 repos with uncommitted changes (urgency-scored):  ◉ eidosagi.com 12 files · 8 new · last commit 2h ago  ◉ checkout-svc 5 files · 1 new · mid-TASK-031  ◉ scribe 2 files · 0 new · yesterday  interrupted sessions 2 crashed in last 24h:  session-af12 checkout-svc · feat/auth-migration · 3h ago  last msg: "running migration on staging..." · TASK-031  resume: cr --resume af12  session-b7e9 eidosagi.com · feat/reveals · 8h ago  resume: cr --resume b7e9   

2. Pick up the crashed session — context restored, agent continues

agent · resumed session-af12

  › merge_context id=session-af12 mode=hybrid resume-resume reading session-af12.jsonl (412 turns)...  summary you were migrating auth off legacy session tokens task TASK-031 · "stand up blue-green cutover" adr ADR-042 blue-green (scored 7.7) state PR #214 open · 3 / 5 DoD checks green last action applied migration 0042 on staging · crash before 0043 next run migration 0043; re-run 42/42 test suite  agent context merged · picking up at migration 0043.  zero re-explanation, no "what was I doing again?"   

Dirty repos bypass time filters — uncommitted work doesn't age out of the list. BM25 search scans 5,000+ prior sessions in ~3 seconds, so a question like "where did we test the eidos vs claude thing?" resolves instantly instead of being re-litigated.

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.