Skip to content
Development
Command

/memory-health

Check the health status of all memory files and hooks.

From plugin
13219 skills19 commands9 hooks
shell
$ npx -y skills add HelloRuru/claude-memory-engine --agent claude-code

Ships with claude-memory-engine. Installing the plugin gets this command.

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/memory-health

Context preview

What this command does when you run it.

Check the health status of all memory files and hooks.

Command definition

memory-health.md

/memory-health -- Memory Health Check

Check the health status of all memory files and hooks.

Steps

1. **Scan memory directory**: `~/.claude/projects/{project-id}/memory/` 2. **Scan sessions directory**: `~/.claude/sessions/` 3. **Scan diary directory**: `~/.claude/sessions/diary/` 4. **Scan learned directory**: `~/.claude/skills/learned/` 5. **Check debug log**: `~/.claude/sessions/debug.log`

Output Format

Memory Health Report

MEMORY.md level: {lines}/200 ({percent}%) {Safe/Warning/Critical}

Memory files:
| File | Lines | Last Updated | Status |
|------|-------|-------------|--------|
| {filename} | {lines} | {date} | {OK/Stale/Too Large} |

Sessions: {N} total, latest: {date}
Diary entries: {N} total, latest: {date}
Pitfall records: {N} total, latest: {date}
Learned Skills: {N} total

Hooks status:
- session-start.js: {OK/Error}
- session-end.js: {OK/Error} (debug.log last: {msg})
- memory-sync.js: {OK}
- write-guard.js: {OK}
- pre-push-check.js: {OK}

Thresholds

  • MEMORY.md < 170 lines -> Safe
  • MEMORY.md 170-200 lines -> Warning, suggest moving content to topic files
  • MEMORY.md > 200 lines -> Critical, content beyond line 200 is truncated by Claude
  • Memory file not updated for 30+ days -> Stale
  • Memory file over 200 lines -> Too Large
Read it on GitHub ↗
Ships withclaude-memory-engine

Claude Code 的記憶系統 | A memory system built with hooks + markdown. Zero dependencies.

Get the whole plugin, auto-invoked
Stats
132
Stars
0
Views
27
Forks
Maintained
Maintenance
JavaScript
Language
MIT
License
2mo ago
Last commit
4mo ago
Created

Repo: HelloRuru/claude-memory-engine