memory-curator · qdhenry — Claude Code subagent: what it does, how to install
memory-curator manages semantic memory trees, merges related nodes, and creates checkpoints to prevent knowledge loss.
no license ★ 1,357 updated 2026-03-01
.claude/agents/memory-curator.mdWhat memory-curator does
Operating under the persona Mnemonic, this agent monitors semantic trees located in .wfgy/trees/. It calculates node importance using recency, access frequency, and structural centrality. Highly ranked memories stay protected because the curator refuses to discard critical nodes without direct user consent.
The subagent runs on the Sonnet model and uses standard filesystem, search, and shell tools. Workflows trigger via asterisk commands such as *optimize-tree, *memory-health, or *create-checkpoint.
Operational dependencies live in .claude/commands/memory/ and .claude/commands/semantic/. Without these command files in place, execution of specific pruning and compression steps will fail.
What it helps with
- compress sprawling semantic memory trees
- merge overlapping concept nodes
- create recovery checkpoints before pruning
- assess the semantic value of stored knowledge
Example prompts for the agent
- Check current memory status and run
*memory-health - Save a restore point using
*create-checkpoint - Clean up redundant concepts with
*optimize-tree
How to install memory-curator
Manually: put the files in place
.claude/agents/memory-curator.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/memory-curator.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/memory-curator.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about memory-curator
How to install memory-curator in Claude Code?
Place the agent configuration file at .claude/agents/memory-curator.md.
What does memory-curator do?
It audits semantic trees in .wfgy/trees/, compresses node descriptions, and discards low-value entries. Checkpoint mechanisms ensure previous states remain restorable.
Where does the agent load task workflows from?
It reads instructions from .claude/commands/memory/ and .claude/commands/semantic/. Files are loaded on demand when a matching command runs.
Similar subagents
All subagents for Agent setup: memory, context, orchestration →memory-curator by other authors comes first.