Memory Management

Usage

$manage-memory
$manage-memory "list --store workflow"
$manage-memory "search authentication"
$manage-memory "view MEM-20260318-001"
$manage-memory "edit MEMORY.md"
$manage-memory "delete TIP-20260318-001 --confirm"
$manage-memory "prune --before 2026-01-01 --type tip --dry-run"

---

Implementation

Step 1: Resolve Store Paths

• Workflow store: .workflow/memory/ (entries: MEM-*.md, TIP-*.md, index: memory-index.json)
• System store: ~/.claude/projects/{project}/memory/ (files: MEMORY.md + topic .md files)

Derive system path from project root (replace path separators with --, prefix drive letter).

Step 2: Parse Subcommand

Default to list if no arguments. Parse first token as subcommand.

Step 3: Execute Subcommand

list: Show entries from both stores (or filtered by --store, --tag, --type).

• Workflow: read memory-index.json, display ID, type, date, tags, title
• System: list .md files in system memory directory

search <query>: Full-text grep across both stores. Rank by match count.

view <id|file>: Auto-detect store from format (MEM-*/TIP-* = workflow, else system). Display full content.

edit <file>: Edit a system memory file. Read current content, apply changes. Warn if MEMORY.md exceeds 200 lines (W003).

delete <id|file>: Require confirmation (or --confirm flag). MEMORY.md cannot be deleted (E004). Remove entry file and update memory-index.json.

prune: Requires at least one filter (--tag, --type, --before, --after). Workflow store only. --dry-run previews without deleting.

Step 4: Integrity Check

After write operations, verify:

• No orphaned files without index entries (W001)
• No dangling index references to missing files (W001)
• System MEMORY.md references valid topic files (W002)

---

Error Handling

Code	Severity	Description
E001	error	No memory stores found -- run Skill({ skill: "memory-capture" }) or create MEMORY.md
E002	error	Entry ID or filename not found
E003	error	Prune requires at least one filter flag
E004	error	Cannot delete MEMORY.md -- use edit subcommand instead
W001	warning	Index has orphaned files or dangling references
W002	warning	MEMORY.md references non-existent topic file
W003	warning	MEMORY.md exceeds 200 lines -- content truncated at load