Bm Remember
Quickly capture a thought, fact, or reminder into Basic Memory as a lightweight note.
Install
npx skills add basicmachines-co/basic-memory --skill bm-remember -g -a claude-code -y- Repository
- basicmachines-co/basic-memory4.4k
- Category
- Engineering
- Updated
- 3d ago
- License
- AGPL-3.0
- Context cost
- Lightabout 734 tokens
- Runs scripts
- No, instructions only
What it does
Quickly capture a thought, fact, or reminder into Basic Memory as a lightweight note. Use when the user says "remember that…", "note this", "save this to memory", or runs /basic-memory:bm-remember. For quick deliberate capture, not full decision or session records.
Remember
Capture $ARGUMENTS into Basic Memory as a quick note, keeping the user's words.
When no project is pinned, discover projects with bm_project(command="list")
and pass the selected project's external ID as project on note/search calls.
With several addressable projects, these calls require an explicit scope even
when a default is configured.
Steps
-
Resolve config. Read the
basicMemoryblock with the same precedence the hooks use. For the user-level base, appendsettings.jsonto the literal value ofCLAUDE_CONFIG_DIRwhen that environment variable is present; do not trim it, expand~, or treat an empty value as unset. Use~/.claude/settings.jsononly when the variable is absent. Then the project's.claude/settings.jsonand.claude/settings.local.jsonoverride it per key. A user-level block alone is enough; a project can still pin its own values:rememberFolder, folder for quick captures (default:bm-remember)primaryProject, project to write to (when absent, discover projects and explicitly select the listed default or sole project)
Both are optional. Use the defaults if the block or a key is missing. Don't fail if there's no settings file.
-
Derive the note. Apply the
bm-writingskill before drafting; match its depth to this lightweight capture, keep the user's wording and do not pad a small fact into an essay.- Content = the text in
$ARGUMENTS, verbatim. Don't rewrite or pad it. - Title = the first line of that text, trimmed to ≤ 80 characters (append
…if you truncate). If it's one long line, write a short descriptive title instead. - If
$ARGUMENTSis empty (e.g. you were invoked because the user said "remember that…"), capture the specific thing they asked you to remember from the conversation. If it's genuinely unclear what to save, ask one short question.
- Content = the text in
