AI Memory Library

Keep architectural decisions, lessons, and conventions in workspace or group libraries, then use Recall to search across sessions.

Set up a library

Create or select a memory library in Settings > Memory Library and associate its workspaces. Libraries can cover one workspace or a group. Install the generated recall skill for your target AI tool; use its generated path rather than a generic recall directory.

Commands

Replace SKILL_PATH with the installed recall skill directory. Quote the whole search phrase: recall.sh searches only its first argument. It tries BM25 search through the API, with a local text-search fallback.

"$SKILL_PATH/recall.sh" "terminal session"
"$SKILL_PATH/remember.sh" architecture "Use EventBus for cross-service communication"
"$SKILL_PATH/remember.sh" lesson "Record the failure and its reproduction steps"
"$SKILL_PATH/forget.sh" "old auth pattern"

remember.sh saves a categorized memory. forget.sh lists matching candidates for review; it does not delete them. Inspect candidates in Memory Library before running archive, restore, delete, merge, or prune actions.

Categories and usage

  • architecture: design decisions and technology choices.
  • lesson: debugging discoveries and edge cases.
  • pattern: reusable solutions and conventions.
  • style: naming and code organization.
  • preference: tooling and workflow preferences.

Search prior decisions before choosing an approach; save confirmed lessons after solving a problem. When a remembered claim is stale or misleading, review its evidence and status before using it again.

Storage

Configuration lives at ~/.termdock/memory/config.json. A single-workspace library uses workspaces/<hash>; a grouped library uses groups/<hash>. Each library has index.md and entries.json under ~/.termdock/memory/. The generated skill points at its library.

~/.termdock/memory/config.json
~/.termdock/memory/workspaces/<hash>/index.md
~/.termdock/memory/workspaces/<hash>/entries.json
~/.termdock/memory/groups/<hash>/index.md
~/.termdock/memory/groups/<hash>/entries.json

Use maintenance actions instead of editing raw memory files as the default workflow. Before moving or deleting a library, back it up and verify the copy.

Review and maintenance

The Memory Library review panel shows health summaries and maintenance signals. Filter by status, category, source, or text; edit, pin, archive, restore, or delete entries. Archive lets you set an entry aside while preserving it for review.