What problem does it solve?
session-wrap automates the tedious and error-prone process of summarizing development work at the end of a session, ensuring per-project handoff records, deduplicated lesson capture, and consistent memory updates instead of manual notes or ad-hoc text files.
Core Features & Use Cases
- Per-project handoff files: Generates a timestamped handoff file in a project-scoped path to avoid cross-project overwrites.
- Git-aware collection: Collects recent commits, diff stats, changed filenames, and uncommitted status when run inside a git repository.
- Structured summary and lessons: Produces a concise session summary, next-actions list, document-sync hints, and extracts up to five lessons classified by type (error, insight, preference, gotcha, workflow).
- Memory management: Appends lessons to project MEMORY.md and lessons.jsonl with ID sequencing, duplicate detection, archiving, and optional categorization via a local script.
- Operational controls: Supports --dry-run to preview output and --confirm to require explicit user approval before writing files; resilient to non-git directories and various failure modes.
- Use case: Run at the end of a feature branch to produce a handoff for reviewers, record lessons for the project memory, and mark plan phases as complete.
Quick Start
Run session-wrap in your project directory to generate a per-project handoff and append new lessons to MEMORY.md.
