What problem does it solve?
It prevents you from losing important progress, decisions, and context when switching between conversations or restarting work, by providing a lightweight way to persist and retrieve session state.
Core Features & Use Cases
- Session saving with a structured summary: Captures goals, completed work, key decisions, changed files, invoked agents, open items, and a context snapshot into ~/.claude/sessions/.
- Context recovery from project history or HANDOFF.md: Restores the most relevant prior session for the current project, or uses HANDOFF.md if present in the working directory.
- Topic search across sessions and observations: Finds past sessions and, optionally, related tool observations using index-based, timeline, or full-detail search modes.
Use case: You pause a complex refactor, later return to the same project, and want the exact goal, decisions, open items, and relevant surrounding context without rereading everything.
Quick Start
Tell the AI to run context-manager save for your current project session so it writes a complete summary to your sessions directory.
