By talgolan
Audit a Claude Code project memory dir for rot: dangling index pointers, orphan files, unresolved [[links]], shipped/DONE archive candidates, oversize index, and frontmatter/slug issues. Read-only report; fixes are proposed for your approval. One slash command: /memory-audit.
A Claude Code plugin that audits a project memory directory — a MEMORY.md
index plus per-fact *.md files — for rot, and proposes fixes you approve
before anything is written.
One slash command: /memory-audit.
File-based memory (a MEMORY.md index loaded every session + one file per fact)
drifts over time: a shipped task still listed as "NEXT", a *.md deleted but its
index line left behind, a [[link]] whose target was renamed, near-duplicate
feedback notes, an index that quietly grows past the point of being cheap to load.
None of it is catastrophic; all of it costs context-window budget and trust.
This plugin makes the audit one command instead of a manual grep sweep — and keeps a human gate on every change. The detection is a read-only script; Claude turns findings into proposed fixes you approve.
| Category | Meaning |
|---|---|
dangling_index | MEMORY.md links a *.md file that doesn't exist |
orphan_file | a *.md file exists but no index line points to it |
unresolved_link | a [[slug]] with no file whose name: matches |
done_candidate | a project_* index line flagged DONE/SHIPPED/MERGED (archive?) |
oversize_index | active index exceeds the threshold (default 25 lines) |
slug_mismatch | a name: uses underscores (convention is hyphen-case) |
missing_frontmatter | a *.md lacks name:/description: |
scripts/memory-audit.zsh is READ-ONLY. It scans and reports. It never
edits, moves, or deletes. Run it as often as you like with zero risk.After installing (below), in any project with a memory dir:
/memory-audit
It auto-detects the memory dir ($CLAUDE_MEMORY_DIR → nearest memory/MEMORY.md
walking up from cwd → ~/.claude/projects/<slug>/memory). Or run the script
directly:
zsh scripts/memory-audit.zsh --dir /path/to/memory # human report
zsh scripts/memory-audit.zsh --dir /path/to/memory --json # machine output
zsh scripts/memory-audit.zsh --max-index 30 # custom threshold
Requirements: zsh (macOS/Linux), standard grep/sed. No build step.
/plugin marketplace add talgolan/memory-audit-plugin
/plugin install memory-audit-plugin@talgolan
Update later:
/plugin marketplace update talgolan
talgolan marketplace.claude-plugin/marketplace.json here defines a talgolan catalog that lists
this plugin alongside smoke-test-skill and session-continuity. To graduate to
a single dedicated catalog repo (recommended once you have 3+ plugins), move this
marketplace.json into a standalone talgolan/marketplace repo and keep each
plugin in its own repo (the source entries already point at the per-plugin
github repos). Until then, adding this repo as a marketplace exposes all three.
MIT — see LICENSE.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub talgolan/claude-plugins --plugin memory-audit-pluginCross-session memory for Claude Code projects via two in-repo docs: SESSION_PRIMER.md (current state) and LEARNINGS.md (hard-won bugs).
Scaffold an executable smoke-test framework into any project. Two slash commands: /smoke-init scaffolds the framework + first runner; /smoke-add scaffolds additional runners.
Memory compression system for Claude Code - persist context across sessions
Editorial "Web Designer" bundle for Claude Code from Antigravity Awesome Skills.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Frontend design skill for UI/UX implementation
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, ad creative, and growth