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

37 lines
1.1 KiB
Markdown

---
id: remember
title: bd remember
slug: /cli-reference/remember
sidebar_position: 999
---
<!-- AUTO-GENERATED: do not edit manually -->
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
```