alexknowshtmlalexknowshtmlCommunityยท1 Agent Skills Included

claude-memory-health

Audit, clean, and archive Claude Code memory files

Audits Claude Code memory indexes for bloat, orphaned files, broken links, and stale entries. Prevents silent truncation of memories past the 200-line session limit and stops old notes from diluting important context. Demotes low-priority entries to searchable cold storage automatically on a schedule, keeping every session fast and focused.
npx skills add alexknowshtml/claude-memory-health --all -g -y

All Skills in This Repository (1)

Pure Emerald Level Indicators

Frequently Asked Questions

FAQPage Schema
How to install claude-memory-health?โ–ผ

Run `npx skills add alexknowshtml/claude-memory-health --all -g -y` in your terminal to install the skill globally.

Why do my Claude Code memories disappear?โ–ผ

Claude Code only loads the first 200 lines of MEMORY.md at session start, so anything past that is silently dropped. This skill audits your index and keeps it under the limit.

How does memory-health clean up memory files?โ–ผ

It scans for oversized sections, orphaned files, broken links, and stale entries, then moves low-priority notes into searchable cold-storage domain files after your approval.

Can memory cleanup run automatically on a schedule?โ–ผ

Yes. The included scheduler script runs Claude headlessly via cron to classify and demote entries whenever MEMORY.md exceeds your chosen line threshold.

What do I need to run claude-memory-health?โ–ผ

You need Claude Code and Bun installed, plus MEMDIR and COLDDIR environment variables pointing to your memory and cold-storage directories.

Related Repositories in Software Engineering

View All in Software Engineeringโ†’