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.
Install
npx skillscat add basicmachines-co/basic-memory/bm-remember Install via the SkillsCat registry.
Remember
Capture $ARGUMENTS into Basic Memory as a quick note, keeping the user's words.
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.json
only when the variable is absent. Then the project's.claude/settings.json
and.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 (default: omit theprojectargument so
Basic Memory uses its default 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
Write it with
write_note:title= the derived titledirectory= the resolvedrememberFoldercontent= the texttags=["manual-capture"]- Route to
primaryProjectif set: pass it asproject, or asproject_idif
it's anexternal_idUUID (a bare UUID inprojectwon't route). Omit both ifprimaryProjectisn't set.
Don't overwrite an existing note unless the user explicitly asks.
Confirm in one line: what was saved and its permalink —
e.g.Saved → bm-remember/<slug>.
Notes
- This is a quick capture. Keep the user's wording; don't add observations,
relations, or structure unless they ask. - For a decision with rationale and alternatives, use the
bm-decideskill
instead (the basic-memory output style also captures these inline). Wrapping up
a work session isbm-checkpoint's job, not this skill's. - Use whichever Basic Memory MCP server is connected — don't assume a specific tool
name prefix.