AI Memory Library

Persistent cross-session memory for architectural decisions, lessons learned, and coding patterns. Never lose context between AI coding sessions.

Overview

The Memory skill (Recall) allows Claude Code and other AI tools to remember important decisions, gotchas, and patterns across sessions. Instead of repeating the same explanations, save them once and recall when needed.

remember.sh

Save new memories

recall.sh

Search memories

forget.sh

Remove outdated

Commands

recall.sh - Search Memories

./recall.sh <keywords>

Search for memories by keywords. Returns matching memories with their categories and timestamps.

Examples:

./recall.sh terminal session
./recall.sh "error handling"
./recall.sh authentication JWT

remember.sh - Save Memory

./remember.sh <category> "<content>"

Save a new memory with a category for organization.

Examples:

./remember.sh lesson "node-pty requires explicit shell path on macOS"
./remember.sh architecture "Use EventBus for cross-service communication"
./remember.sh pattern "Always validate user input at API boundaries"
./remember.sh style "Use camelCase for variables, PascalCase for classes"
./remember.sh preference "Prefer functional components over class components"

forget.sh - Remove Memory

./forget.sh "<keywords>"

Remove outdated or incorrect memories by keywords.

Example:

./forget.sh "old authentication method"

Memory Categories

architecture

Design decisions, technology choices, system structure

"Use microservices for user management"

lesson

Gotchas, debugging discoveries, edge cases

"WebSocket reconnects need exponential backoff"

pattern

Reusable solutions, conventions, best practices

"Use factory pattern for terminal creation"

style

Naming conventions, code organization

"Prefix private methods with underscore"

preference

Tooling preferences, workflow choices

"Use pnpm over npm for faster installs"

Proactive Usage Guidelines

1. Session Start

When user mentions a feature/module, search for related memories first:

User: "let's work on authentication"
AI: ./recall.sh authentication

2. Before Decisions

Before making architectural or technical choices, check existing decisions:

About to choose a library → check prior decisions
Designing a new feature → search for related patterns

3. After Problem Solving

When you've solved a tricky issue, save it:

Found a non-obvious bug → ./remember.sh lesson "description"
Made an important decision → ./remember.sh architecture "description"

4. Encountering Familiar Issues

When something seems like a recurring problem:

Error looks familiar → ./recall.sh "error type"

Storage Location

Memories are stored in a JSON file at:

~/.termdock/memories.json

You can also view and manage memories in Termdock's Settings → Memory Library UI.

Installing Memory Skill for Claude Code

  1. Open Settings → Skills tab in Termdock
  2. Select Claude Code as target
  3. Click Install on "recall" skill
  4. Claude Code will proactively use memory when relevant

Optional: Install Hooks

You can also install the /remember slash command for quick memory saving during conversations.