Post Compact Reminder

Post-Compact Reminder for Claude Code

Stop Claude from forgetting your project rules after context compaction.

Quick Install

TL;DR

The Problem: During long coding sessions, Claude Code compacts the conversation to stay within context limits. After compaction, Claude loses all memory of your project's AGENTS.md, the file that defines your coding conventions, forbidden commands, architectural decisions, multi-agent coordination rules, and everything else that keeps Claude on the rails. The result: Claude starts freelancing, ignoring your rules, deleting files you told it never to delete, and generally going on a post-compaction rampage.

The Solution: A hook system that detects compaction events and injects a short plain-text reminder telling Claude to re-read AGENTS.md before doing anything else. One install, zero maintenance, works globally across all your projects.

Why Use Post-Compact Reminder?

Quick Example

After installation, when compaction happens:
1. Claude Code triggers the SessionStart hook with source: "compact"
2. The matcher: "compact" filter ensures the hook only fires after compaction
3. Claude receives the reminder directly in its context
4. Claude re-reads AGENTS.md before proceeding

Design Philosophy

1. Simplicity.
A single SessionStart hook with matcher: "compact" detects compaction and injects the reminder directly. No marker files, no multi-hook coordination -- just one hook that fires at the right time.

2. Atomic file operations.
Every modification to settings.json is written to a temp file first, then moved into place with shutil.move(). If the process crashes mid-write, your settings file stays intact. Backups are created automatically before every modification.

3. One installer, complete functionality.
The entire project is a single…