MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads bm-remember automatically when relevant.

  3. 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

  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 (default: omit the project argument 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.

  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.
  3. Write it with write_note:

    • title = the derived title
    • directory = the resolved rememberFolder
    • content = the text
    • tags = ["manual-capture"]
    • Route to primaryProject if set: pass it as project, or as project_id if it's an external_id UUID (a bare UUID in project won't route). Omit both if primaryProject isn't set. Don't overwrite an existing note unless the user explicitly asks.
  4. 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-decide skill instead (the basic-memory output style also captures these inline). Wrapping up a work session is bm-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

View all →

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.

Docs & Writing1.3K installs

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?'

1.3K installs

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.

1.3K installs

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.

Docs & Writing1.3K installs

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.

Docs & Writing1.2K installs

Popular other skills

View category →

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.

1.3M installs

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.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs