session-compaction

Session compaction condenses your conversation history into a structured, persistent checkpoint saved as Markdown. Run the compact command to generate a summary with quality scoring, then load it to resume context and continuity in future sessions without losing progress.

Compaction analyzes your current session, generates a fixed-format summary with artifact tracking, performs four self-evaluation probes to assess quality, and saves the result to history/threads/YYYY-MM-DD-HH-MM-compact.md for persistent storage and later recall.

Yes. Compaction is designed for long-running conversations and session termination. It creates durable checkpoints that support resumable state, so you can end your session and pick up exactly where you left off using the saved summary.

Session compaction enforces a quality threshold by running four self-evaluation probes against the generated summary. These probes assess usefulness and ensure the checkpoint meets functional requirements before saving to your history file.

Compacted sessions are saved to history/threads/YYYY-MM-DD-HH-MM-compact.md by default, or to a custom path you specify. The file persists your checkpoint in Markdown format for easy resumption and artifact tracking across sessions.

Session compaction generates a fixed-format Markdown summary designed for structural repeatability and quick recall. This format supports artifact tracking and enables continuity when you load the checkpoint back into a new session.