AI agent skill · by @basicmachines-co

Bm Remember

Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.

Archived 2026-10-23 · Source updated 2026-09-16 · License: AGPL-3.0. Check the original repository for the latest version.

SKILL.md instructions

# Remember

Use this for lightweight capture: "remember that", "save this", "note this", or
a small fact that should survive the current thread.

## Steps

1. Read `~/.codex/basic-memory.json`, then the nearest project
   `.codex/basic-memory.json`; project keys override user keys:
   - `primaryProject`, default omitted
   - `rememberFolder`, default `codex/remember`

   Apply the `bm-writing` skill before drafting the note. Match its depth to this
   lightweight capture; do not pad a small fact into an essay.

2. Identify the exact text to save. If the user supplied text, preserve their
   wording. If the user said "remember that" and the referent is unclear, ask one
   short question.

3. Write with `write_note`:
   - `title`: first line trimmed to 80 characters, or a short descriptive title
   - `directory`: `rememberFolder`
   - `content`: the text to remember
   - `tags`: `["codex", "manual-capture"]`
   - route to `primaryProject` if configured

4. Confirm in one line with the permalink.

Do not use this for decisions with alternatives or for work handoffs. Use
`bm-decide` or `bm-checkpoint` for those.