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.
Source facts
- Repository
- basicmachines-co/basic-memory
- Last source activity
- October 24, 2026 at 17:18
- Detected SKILL.md language
- English
- Stars
- 4,391
- Forks
- 343
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
3 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- bm-remember
- description
- Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.
# 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 `bm_write`:
- `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.
View on GitHub