# memory-auditor

The memory-auditor subagent for Claude Code checks memory against code and Git, flagging stale or duplicate entries. Run it after a major refactor.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/agents/memory-auditor.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/memory-auditor

## What it does

memory-auditor checks paths, functions, versions, settings, and conventions mentioned in memory against the project and Git history. It looks for deleted or renamed entities, changed behavior, and relative dates that have lost their meaning. Its tools are `Read`, `Grep`, `Glob`, and `Bash(git:*)`.

The agent also spots overlapping entries and flags material that is outdated, repetitive, or too generic to guide future work. Code or Git evidence is required for factual findings; principles and preferences are judged against the memory corpus itself. When an entity is missing from the working tree, the agent checks whether it may belong to an external dependency before calling it stale.

For Claude Code, add the `Claudest` marketplace and install `claude-memory@Claudest`; the agent file path is `.claude/agents/memory-auditor.md`. Audits outside a Git repository have no project history to consult, so conclusions about changes need care.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-memory@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/agents/memory-auditor.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/memory-auditor.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/memory-auditor.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/agents/memory-auditor.md

## When to use it
- find memory references to deleted or renamed files
- check whether remembered versions and settings still match the project
- flag relative dates that need an absolute date
- catch disagreements between memory entries and code
- identify stale or duplicate entries to merge or remove

## Example prompts
- Check the memory entries after this refactor and find stale file or function references.
- Compare the versions and settings in memory with the code and Git history.
- Find overlapping memory entries about this decision and suggest what to merge or remove.

## Similar
- [groove-utilities-memory-retrospective](https://affpapa.org/en/nevibecode/skills/groove-utilities-memory-retrospective.md) — skill · 517 installs
- [memory-mcp](https://affpapa.org/en/nevibecode/mcp/memory-mcp.md) — MCP server · ★ 100 repo stars
- [groove-utilities-memory-log-daily](https://affpapa.org/en/nevibecode/skills/groove-utilities-memory-log-daily.md) — skill · 583 installs
- [memory-compaction](https://affpapa.org/en/nevibecode/skills/memory-compaction.md) — skill · ★ 285 repo stars
- [memory-hygiene](https://affpapa.org/en/nevibecode/skills/memory-hygiene.md) — skill · ★ 33 repo stars
- [neverinfamous-memory-journal-mcp](https://affpapa.org/en/nevibecode/mcp/neverinfamous-memory-journal-mcp.md) — MCP server · ★ 20 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
