Skills

Bm Remember

Quickly save a small fact, reminder, or user preference into Basic Memory from Codex...

Install

npx skills add basicmachines-co/basic-memory --skill bm-remember -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
AGPL-3.0
Context cost
Lightabout 281 tokens
Runs scripts
No, instructions only

What it does

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.

More in Engineering