Stats
Actions
Tags
From nemp
Runs health checks on Nemp Memory system: verifies .nemp directory, memories.json validity and integrity, CLAUDE.md sync, and outputs scored report with issues.
How this command is triggered — by the user, by Claude, or both
Slash command
/nemp:healthThe summary Claude sees in its command listing — used to decide when to auto-load this command
# /nemp:health Run a health check on your Nemp Memory system. Detect corruption, stale data, sync drift, orphaned keys, and silent degradation before they cause problems. ## Usage ## Why This Exists Every memory tool assumes your data is fine. They silently degrade — ghost references, corrupted indexes, stale CLAUDE.md, orphaned keys. You don't notice until the agent makes a wrong decision based on bad context. `/nemp:health` catches problems before they break your agent. ## Instructions When the user invokes `/nemp:health`, run ALL checks below in sequence, then display a scored re...
Run a health check on your Nemp Memory system. Detect corruption, stale data, sync drift, orphaned keys, and silent degradation before they cause problems.
/nemp:health # Run health check with score and issues list
Every memory tool assumes your data is fine. They silently degrade — ghost references, corrupted indexes, stale CLAUDE.md, orphaned keys. You don't notice until the agent makes a wrong decision based on bad context.
/nemp:health catches problems before they break your agent.
When the user invokes /nemp:health, run ALL checks below in sequence, then display a scored report.
[ -d ".nemp" ] && echo "NEMP_DIR_EXISTS" || echo "NEMP_DIR_MISSING"
If .nemp/ doesn't exist:
❌ CRITICAL: No .nemp/ directory found.
Run /nemp:init to initialize Nemp Memory.
Stop here — no further checks possible.
[ -f ".nemp/memories.json" ] && python3 -c "import json; data=json.load(open('.nemp/memories.json')); print(f'VALID_JSON entries={len(data)}')" 2>&1 || echo "MISSING_OR_INVALID"
Checks:
For each memory entry in memories.json, verify:
3a. Key format:
3b. Value length:
3c. Empty values:
3d. Duplicate keys:
3e. Timestamp integrity:
created should be a valid ISO-8601 dateupdated should be >= created3f. Missing required fields:
[ -f "CLAUDE.md" ] && echo "CLAUDE_MD_EXISTS" || echo "CLAUDE_MD_MISSING"
4a. CLAUDE.md exists?
4b. Nemp section present?
## Project Context (via Nemp Memory)4c. Sync freshness:
updated timestamp in memories.json4d. Content drift:
[ -f ".nemp/access.log" ] && wc -l .nemp/access.log && head -1 .nemp/access.log && tail -1 .nemp/access.log || echo "NO_ACCESS_LOG"
Checks:
[ -f ".nemp/config.json" ] && cat .nemp/config.json || echo "NO_CONFIG"
Checks:
[ -f ".nemp/MEMORY.md" ] && echo "MEMORY_MD_EXISTS" || echo "MEMORY_MD_MISSING"
Checks:
[ -f "$HOME/.nemp/memories.json" ] && python3 -c "import json; data=json.load(open('$HOME/.nemp/memories.json')); print(f'VALID entries={len(data)}')" 2>&1 || echo "NO_GLOBAL"
Checks:
[ -f ".nemp/cortex.json" ] && echo "CORTEX_EXISTS" || echo "NO_CORTEX"
[ -f ".nemp/episodes.json" ] && echo "EPISODES_EXISTS" || echo "NO_EPISODES"
[ -f ".nemp/archive.json" ] && echo "ARCHIVE_EXISTS" || echo "NO_ARCHIVE"
Checks:
vitality.state == "fading" or "dormant" → ℹ️ if anyScore each check on a weighted scale:
| Check | Weight | Pass | Fail |
|---|---|---|---|
| .nemp/ exists | 10 | 10 | 0 |
| memories.json valid | 18 | 18 | 0 |
| No empty values | 7 | 7 | -4 per empty |
| Values under 200 chars | 5 | 5 | -1 per oversized |
| Timestamps valid | 5 | 5 | -1 per invalid |
| CLAUDE.md in sync | 10 | 10 | 0 if stale |
| Access log exists | 5 | 5 | 0 |
| Config exists | 5 | 5 | 0 |
| MEMORY.md in sync | 5 | 5 | 0 |
| No duplicate keys | 5 | 5 | -2 per duplicate |
| Global memories valid | 5 | 5 | 0 |
Total possible: 80
Score bands:
Nemp Memory Health Check
Score: 73/80 🟢 HEALTHY
✅ memories.json — 23 memories, all valid
✅ CLAUDE.md — in sync (last sync: 2 min ago)
⚠️ 2 memories exceed 200 char limit
❌ Key "auth-flow" has empty value
✅ Access log — 47 entries, no gaps
✅ Config — autoSync enabled
✅ Global — 4 global memories
Issues found: 2
⚠️ auth-strategy: value is 247 chars (compress with /nemp:save)
❌ auth-flow: empty value (delete with /nemp:forget auth-flow)
Quick fix:
/nemp:save auth-strategy "<shorter version>"
/nemp:forget auth-flow
If no issues found:
✅ All checks passed. Memory system is healthy.
.nemp/ doesn't exist → Stop with init prompt/nemp:init — Initialize Nemp Memory/nemp:export — Sync memories to CLAUDE.md/nemp:list — View all memories/nemp:save — Save or update a memory/nemp:forget — Remove a memoryUnlock advanced diagnostics with Nemp Pro:
/nemp:health --verbose — Show pass/fail status for every check/nemp:health --fix — Auto-fix safe issues (empty values, missing files)/nemp:cortex — Memory intelligence with trust scores and conflict detectionAlready have a license? Run /nemp:activate <key> to unlock.
npx claudepluginhub sukinshetty/nemp-memory --plugin nemp/statusShows CLAUDE.md (or AGENTS.md) memory sync status: pending changes count, last sync time, file locations, and config settings. Offers /auto-memory:calibrate if pending.
/memory-healthChecks AutoMem memory service health and connection status, reports FalkorDB graph DB, Qdrant vector DB status, and provides troubleshooting if unhealthy.
/custodianAudits memory files for health (default), validates links/relationships/frontmatter, relocates paths, recalculates decay, summarizes for compression.
/memory-statusDisplays Pensyve memory namespace statistics and health overview, including counts by type, known entities list, storage info, and next-step suggestions.
/memory-consolidateCleans .memory/ directory: deduplicates entries, removes stale/contradictory/derivable info, rebuilds index. Generates report of changes; supports --dry-run.
/updateRuns intelligent maintenance on memory database and tool resource registry — cleans up, deduplicates, compresses, and reindexes data.