recall-add

name	recall-add
description	Add a structured memory record to Recall — breadcrumb, decision, or learning

Codex routing

Prefer the memory_add MCP tool. Use the CLI examples below only when the MCP server is unavailable.

The canonical workflow below remains authoritative, but equivalent behavior is not assumed across hosts.

Manually add a structured record to the Recall memory database. Three record types are available: breadcrumbs (context notes), decisions (architectural choices), and learnings (problem/solution pairs). Use the user's request text as the record content.

Usage

# Breadcrumb — quick context note
recall add breadcrumb "<content>"

# Decision — architectural or process decision
recall add decision "<content>" --why "reasoning"

# Learning — problem and solution pair
recall add learning "<problem>" "<solution>"

Breadcrumb options:

• -p <project> — Project name
• -c <category> — Category: context, note, todo, reference
• -i <n> — Importance 1-10 (default: 5)

Decision options:

• -p <project> — Project name
• -w, --why <text> — Why this decision was made
• -a, --alternatives <text> — Alternatives considered

Learning options:

• -p <project> — Project name
• -t, --tags <tags> — Comma-separated tags
• --prevention <text> — How to prevent in future

Examples

# Breadcrumb with high importance
recall add breadcrumb "User prefers dark mode in all UIs" -p myproject -i 8

# Decision with reasoning
recall add decision "Use TypeScript over Python" --why "Type safety, team preference" -p myproject

# Learning with prevention
recall add learning "Port conflict on 4000" "Kill process or change port" --prevention "Use dynamic port allocation"

# Tagged learning
recall add learning "bun:sqlite uses \$param syntax" "Not :param like better-sqlite3" -t "bun,sqlite,gotcha"