os-save

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.