What problem does it solve?
It eliminates lost context between AI sessions by saving what happened, extracting the decisions and current state, and turning them into a snapshot that can be retrieved later.
Core Features & Use Cases
- Session context snapshots: Creates a timestamped memory file in the active project’s memory folder so future sessions start from an accurate, searchable baseline.
- Decision + state capture: Updates the project’s
current-state.md and sessions indexes with active work streams, open questions, and key decisions to keep the narrative coherent across time.
- Portfolio-aware memory: Correctly routes saving for both whole-project sessions and portfolio-item sessions by following
projects.md, CLAUDE.md, and TRACKER.md mappings.
- Optional exploratory reasoning logs: When a session is exploratory, writes a dedicated reasoning appendix and links it from the main snapshot.
Quick Start
Run os-save at the end of your working session to persist the session summary, decisions, and updated project state into the correct project memory.