manage-memory

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