Skip to content
Forgeplan

forgeplan recall

Search the memory store — ad-hoc observations, lessons, and context snippets saved via forgeplan remember. This is Forgeplan’s lightweight personal note-taking lane, separate from artifacts. Use recall when you remember “we learned something about X” but there is no formal PRD or Note.

When to use

Section titled “When to use”
  • “We agreed not to use crate X — why?”
  • Restore context at session start (“recall ‘sprint 13’”)
  • Pull prior lessons before a retro or postmortem
  • Fuel an AI agent with situational memory

Not to use when

Section titled “Not to use when”

Usage

Section titled “Usage”
forgeplan recall [OPTIONS] [QUERY]

Arguments

Section titled “Arguments”
  [QUERY]  Search query (substring match in title/body)

Options

Section titled “Options”
  -c, --category <CATEGORY>  Filter by category
  -n, --limit <LIMIT>        Max results (default: 10) [default: 10]
      --json                 Output as JSON for machine consumption
  -h, --help                 Print help
  -V, --version              Print version

Examples

Section titled “Examples”

Recall everything matching a phrase:

Terminal window
forgeplan recall "branch workflow"

All memories in a category:

Terminal window
forgeplan recall --category build

Dump everything as JSON:

Terminal window
forgeplan recall --json --limit 1000 > memories.json

Output interpretation

Section titled “Output interpretation”

Each hit shows a short card:

[2026-04-05]  build    Do not delete feature branches after merge
   PRs to dev are merge-commit, squash loses late commits. Keep the
   branch until the PR is closed for at least a week.

Columns: date, category, title, then a body excerpt. --json returns the full record including any tags and the source (manual vs auto-retain).

Unlike search, recall is pure substring match with category filtering — fast and predictable, no BM25 or semantic ranking.

How it fits

Section titled “How it fits”

Forgeplan separates artifacts (decisions with lifecycle) from memories (ad-hoc notes without lifecycle):

artifacts   →  list, get, search, graph
memories    →  remember, recall

If a memory is referenced multiple times, promote it to a Note artifact and link it — that’s when it earns lifecycle and evidence.

See also

Section titled “See also”