Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add basicmachines-co/basic-memory --skill bm-remember -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/bm-remember/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bm-remember/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set23

The whole set →
memory-quest memory-quest is a Claude Code skill that verifies an assistant’s connection to Basic Memory Cloud and records the final verification note for Mission 8. CX Codex +1 327installs memory-okf memory-okf — a skill for Claude Code that finds and fixes blockers to exporting a Basic Memory project as OKF v0.2. It runs before publishing, handing off a project, or checking an export bundle. CX Codex +1 305installs memory-agents The memory-agents Claude Code skill creates, runs, and checks Basic Memory Cloud agents. Agents follow instructions on notes and can start when someone creates a note in watched paths. CX Codex +1 268installs memory-doctor The memory-doctor Claude Code skill checks local Basic Memory projects and explains its findings. It runs when search misses or repeats notes, or a save seems to have gone missing. CX Codex +1 249installs bm-setup This Claude Code skill configures Basic Memory through a short interview. It starts when asked to set up Basic Memory or when /basic-memory:bm-setup is run. CX Codex +1 160installs bm-status bm-status is a Claude Code skill that checks Basic Memory's current health and configuration, including CLI access, hook queues, and recent session checkpoints. CX Codex +1 154installs bm-share bm-share copies notes from your personal Basic Memory workspace to a shared team project with author attribution and source permalinks. CX Codex +1 148installs basic-memory basic-memory — a local MCP server that keeps your knowledge in Markdown files on disk and lets the AI read, write and search them. Useful when you are tired of re-explaining project context. CX Codex +1 ★ 4,660repo stars

Project sponsors

Companies that keep this analytics open