What problem does it solve?
resume-session solves the problem of losing context between Claude sessions by reloading the prior session’s progress, summarizing what matters, and prompting the user to choose the next move without making changes.
Core Features & Use Cases
- Resumes from persisted progress.txt: Locates progress.txt across preferred memory paths (or other repo/task locations), confirms it exists, and reads the full file to avoid assumptions.
- Summarizes the last session efficiently: Produces a tight 10–15 line recap including project identity, most recent session date, completed items, in-progress work, top TODOs, and gotchas.
- Performs a drift sanity check: Compares progress.txt’s recorded branch against the current git branch, reviews recent git activity for consistency, and flags any uncommitted changes not reflected in the file.
- Read-only by design: Never writes to progress.txt and never edits code or commits; it only loads and asks what to do next.
Quick Start
Run resume-session to load the last saved progress.txt summary and then tell the AI what you want to do next.