What problem does it solve?
Claude Code sessions can lose meaningful decisions, lessons, and milestones unless every interaction is synthesized and stored; pmm-save ensures each active session state is summarized, merged into the appropriate files, and committed to git so memory compounds instead of rots.
Core Features & Use Cases
- Config-aware orchestration: Reads
memory/config.md to respect maintain agent model, strategy, verbosity, active files, visibility, decay rules, and commit preferences before touching any files.
- Intelligent skipping and hydration: Detects empty work sessions to avoid unnecessary writes, hydrates template-only files when other files are populated, and synthesizes the session delta to guide downstream agents.
- Agent-driven maintenance: Dispatches single or tiered maintain agents with precise prompts, enforces file rules (append-only, attribution tags, decay scoring for Tier 2), and finally commits with an optional auto-push while reporting per verbosity settings.
- Background-safe execution: Supports sequential background saves that monitor for running tasks, handles maintain agents and git commands autonomously, and respects visibility guards like PII handling and protected files.
Quick Start
Use pmm-save to synthesize what changed and commit it before closing the session.