# Bm Remember

Quickly capture a thought, fact, or reminder into Basic Memory as a lightweight note.

- Repository: https://github.com/basicmachines-co/basic-memory (4440 stars)
- Category: Engineering
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add basicmachines-co/basic-memory --skill bm-remember -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill bm-remember -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill bm-remember -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill bm-remember -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

1. **Resolve config.** Read the `basicMemory` block with the same precedence the
   hooks use. For the user-level base, append `settings.json` to the literal value
   of `CLAUDE_CONFIG_DIR` when 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.json` override 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.

2. **Derive the note.** Apply the `bm-writing` skill 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 `$ARGUMENTS` is 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.

The rest: https://github.com/basicmachines-co/basic-memory/blob/HEAD/plugins/claude-code/skills/bm-remember/SKILL.md