bm-remember — Claude Code skill: capture notes instantly
A skill for quick capture of thoughts, facts, or reminders into Basic Memory. Responds to /basic-memory:bm-remember or natural language like "remember that…" — saves text as-is, preserving your wording.
AGPL-3.0 155 installs ★ 4,660 updated 2026-11-16
npx skills add basicmachines-co/basic-memory --skill bm-remember -a claude-codeWhat bm-remember does
bm-remember catches incoming text and writes it to bm-remember folder as a lightweight note with an auto-generated title. For multiline input, the title comes from the first line (capped at 80 characters); for a single long line, the skill creates a short descriptive title instead. It applies guidance from bm-writing but keeps the capture lean—your words stay unchanged.
Configuration lives in the basicMemory block within ~/.claude/settings.json or .claude/settings.json in your project. You can set rememberFolder (defaults to bm-remember) and primaryProject to route captures to a specific Basic Memory project. If no project is pinned, the skill prompts you to pick from available options. Notes always go through bm_write from the connected Basic Memory MCP server and receive the tag manual-capture.
This is a fast capture tool, not for decisions with rationale (bm-decide does that) or session wrap-ups (bm-checkpoint handles those). If you invoke it without text, it asks one brief question to clarify what to save.
What it helps with
- save an idea before it slips away
- move a fact from chat into persistent notes
- batch quick reminders without rewriting
- send a note to a specific Basic Memory project
Example prompts for the agent
- Remember that Postgres 13 requires explicit type coercion in LEFT JOIN
- /basic-memory:bm-remember The API key is in 1Password under Production
- Note this: client approved December 15 deadline, but the API must be ready by the 10th
How to install bm-remember
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-remember -a claude-code2Manually: put the files in place
~/.claude/skills/bm-remember/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bm-remember/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-remember -a codex2Manually: put the files in place
.agents/skills/bm-remember/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-remember -a cursor2Manually: put the files in place
.cursor/skills/bm-remember/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory plugins/claude-code/skills/bm-remember2Manually: put the files in place
.github/skills/bm-remember/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-remember -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory --path plugins/claude-code/skills/bm-rememberManually: put the files in place
.devin/skills/bm-remember/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-remember -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bm-remember
How do I install bm-remember in Claude Code?
Run npx skills add basicmachines-co/basic-memory --skill bm-remember -a claude-code, then open ~/.claude/skills/bm-remember/SKILL.md. On other platforms, the command stays the same except the -a flag changes to codex, cursor, gemini-cli, or opencode.
What does bm-remember do?
It captures text you want to remember and saves it as a note in Basic Memory with an auto-generated title. The content stays as you wrote it—no rewording.
Can I route notes to a specific Basic Memory project?
Yes. Set primaryProject in the basicMemory block of .claude/settings.json (project-level) or ~/.claude/settings.json (user-level). If not set, the skill asks you to choose from available projects or uses the sole default.