Claude Memory Health

claude-memory-health

A Claude Code skill and scheduler for keeping your memory index focused — auditing `MEMORY.md` for bloat and stale entries, then autonomously demoting lower-priority notes to cold storage so the most valuable context loads every session.

---

Install via Claude Code

Paste this into Claude Code to install:

Install the memory-health skill from https://github.com/alexknowshtml/claude-memory-health:

Clone or copy the repo into .claude/skills/memory-health/ in the project root.
The scripts and cold-storage templates are included in the repo — no separate copies needed.

To set up cold storage: copy .claude/skills/memory-health/cold-storage/ to cold-storage/
in the project root as a starting point, then customize the domain files for your project.

Set MEMDIR to ~/.claude/projects/[your-project-name]/memory
Set COLDDIR to [project-root]/cold-storage

Once installed, run /memory-health to audit the memory index.

Requires [Claude Code](https://claude.ai/code) and [Bun](https://bun.sh).

---

The Problem

Claude Code's auto-memory saves a lot. Every correction, fact, and decision ends up in `MEMORY.md` — and it all gets injected at session start. Two problems compound over time:

**Signal dilution.** When everything is always-on, nothing is prioritized. A behavioral rule you need every session competes with an incident fix from three months ago.

**Silent truncation.** Claude Code loads up to 200 lines of `MEMORY.md` at session start. Lines past 200 are silently dropped — no warning, no error. Your oldest memories quietly disappear as new ones accumulate.

The fix isn't to stop saving memories. It's to sort them.

How It Works

**Hot** (`MEMORY.md`) — injected at every session start. Reserve for behavioral rules, communication patterns, safety gates: things Claude needs regardless of what you're working on.

**Cold** (`cold-storage/`) — domain-specific files loaded on demand. Not injected automatically, but searchable when work