
bm-remember
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.
- Installs
- 150
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-remember- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads bm-remember automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.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 (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.
FAQ
What does the bm-remember skill do?
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.
How do I install bm-remember?
Run npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-remember in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/bm-remember/ (personal) or .claude/skills/bm-remember/ (project).
Which AI agents can use bm-remember?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is bm-remember safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains bm-remember?
It is published by basicmachines-co in basicmachines-co/basic-memory. It has 150 recorded installs.
More from basicmachines-co/basic-memory
memory-notes
basicmachines-co/basic-memory
How to write well-structured Basic Memory notes: frontmatter, categorized observations, wiki-link relations, and knowledge-graph best practices. Use when creating or improving notes.
memory-continue
basicmachines-co/basic-memory
Resume prior work by rebuilding context from the Basic Memory graph via memory:// URLs, recent activity, and search. Use at session start or on 'continue with...', 'back to...', 'where were we?'
memory-capture
basicmachines-co/basic-memory
Capture a working thread's current state into one coherent Basic Memory note; on re-capture, rewrite it in place. Use mid- or end-of-thread when decisions, insights, or context are worth keeping.
memory-curate
basicmachines-co/basic-memory
Curate the Basic Memory graph: link orphan notes, propose typed relations, merge duplicates, audit tags and folders, build hub notes. Use to organize and connect a knowledge base as notes accumulate.
memory-reflect
basicmachines-co/basic-memory
Sleep-time reflection: review recent Basic Memory activity and fold lasting decisions, lessons, and facts into the notes they belong in. Run 1-2x daily, on a heartbeat, or when asked.
memory-metadata-search
basicmachines-co/basic-memory
Search Basic Memory notes by custom frontmatter fields with equality, range, array, and nested filters. Use when finding notes by status, priority, confidence, or any YAML field, not free text.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.