pmm-save

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.