memory — Project Memory Bank
Manage a structured, file-based memory bank that persists project context across AI coding agent sessions. Works with Claude Code, Codex, Cursor, and any agent that reads SKILL.md.
Subcommand Router
Determine the subcommand from the user's message. Match the first recognized keyword after the skill invocation (or from natural language triggers like "initialize memory bank").
Available Subcommands
| Command | Purpose |
|---|---|
init [description] | Initialize a new memory bank in the current project |
update | Update memory bank files with current project state |
status | Health check — completeness, consistency, staleness |
export | Consolidate all files into a single markdown document |
ignore | Add memory-bank/ to .gitignore |
track | Remove memory-bank/ from .gitignore |
purge | Delete memory bank and remove agent config imports |
Routing Logic
- Parse the user's message for a subcommand keyword:
init,update,status,export,ignore,track,purge. - If no subcommand is recognized, display the help table above and ask the user which operation they want.
- Check preconditions:
- For init: proceed directly (init handles its own edge cases including reinitialize). - For all other commands: verify memory-bank/ exists in the current working directory. If it does not exist, tell the user: "No memory bank found. Run the init command to create one."
- Read the corresponding reference file and execute its instructions:
- init → Read references/commands/init.md and execute its instructions. - update → Read references/commands/update.md and execute its instructions. - status → Read references/commands/status.md and execute its instructions. - export → Read references/commands/export.md and execute its instructions. - ignore → Read references/commands/ignore.md and execute its instructions. - track → Read references/commands/track.md and execute its instructions. - purge → Read references/commands/purge.md and execute its instructions.
Natural Language Triggers
Map these phrases to subcommands:
- "initialize memory bank", "setup memory bank", "create memory bank" →
init - "update memory bank", "refresh memory", "update project context" →
update - "check memory status", "memory health", "validate memory" →
status - "export memory", "consolidate memory" →
export - "ignore memory bank", "gitignore memory" →
ignore - "track memory bank", "unignore memory" →
track - "purge memory bank", "purge memory" →
purge(requires explicit use of the word "purge" — do not trigger from "delete" or "remove")