memory-health

Auditing a Claude Code MEMORY.md file involves checking the index for size limits, orphaned files, broken links, and stale entries. Running the /memory-health command scans the index and identifies these issues to prevent signal dilution and silent truncation.

Claude Code memory index truncation happens silently when the MEMORY.md file exceeds size limits, causing signal dilution. Auditing the index checks for size constraints and orphaned files to ensure the most valuable context loads every session.

Autonomous demotion to cold storage is a memory management process that moves lower-priority notes out of the active index. It runs headlessly using the Claude CLI to demote stale entries without user interaction, keeping the index focused.

Running memory index audits for Claude Code requires both the Claude Code environment and Bun installed. These dependencies are necessary to execute the scripts that check for orphaned files, broken links, and perform autonomous demotion.

To move lower-priority notes to cold storage in Claude Code, use the autonomous demotion feature. This process runs headlessly with the Claude CLI to automatically identify and demote stale entries, keeping the MEMORY.md index optimized.

The best way to maintain a Claude Code MEMORY.md index is regular auditing for size, broken links, and staleness. Implementing autonomous demotion to cold storage moves lower-priority notes automatically, preventing signal dilution across long-term sessions.