beads/website/docs/cli-reference/remember.md
matt wilkie 7d8063d1d4
docs(cli): regenerate CLI reference for bd remember bare-key reads (#4545)
Main has been red since 9ee97c264 (remember read-paving) landed without
a docs regen: docs/CLI_REFERENCE.md and the website remember page
drifted from live --help, failing the strict CLI-docs freshness probe
in Build Artifacts / PR Policy / doc-flags jobs on every push to main.

Regenerated with scripts/generate-cli-docs.sh (pinned CGO_ENABLED=0
build). Diff is exactly the new bare-key recall paragraph and example.

Agent-Signature: claude-fable-5-high on behalf of matt wilkie

Claude-Session: https://claude.ai/code/session_0167xsjJDukVKE7BE1i4W2wE

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:14:33 -07:00

1.1 KiB

id title slug sidebar_position
remember bd remember /cli-reference/remember 999

Generated from bd help --doc remember

bd remember

Store a memory that persists across sessions and account rotations.

Memories are injected at prime time (bd prime) so you have them in every session without manual loading.

The positional arg is the memory CONTENT (the key is auto-generated from it unless --key is given). As a convenience, if the arg is a bare key naming an existing memory, it is RECALLED instead of stored (same as 'bd recall'); a bare key naming nothing is refused. Use --key to store slug-like content.

Examples: bd remember "always run tests with -race flag" bd remember "Dolt phantom DBs hide in three places" --key dolt-phantoms bd remember "auth module uses JWT not sessions" --key auth-jwt bd remember dolt-phantoms # bare existing key: reads it (= bd recall)

bd remember "<insight>" [flags]

Flags:

      --key string   Explicit key for the memory (auto-generated from content if not set). If a memory with this key already exists, it will be updated in place