# bm-remember

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 155 installs · ★ 4660 repo stars
- Author: basicmachines-co
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basicmachines-co/basic-memory/tree/HEAD/plugins/claude-code/skills/bm-remember/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bm-remember

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-remember -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bm-remember/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bm-remember/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-remember -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bm-remember/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-remember -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bm-remember/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install basicmachines-co/basic-memory plugins/claude-code/skills/bm-remember
```

2. **Manually: put the files in place**
- File: `.github/skills/bm-remember/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-remember -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/basicmachines-co/basic-memory --path plugins/claude-code/skills/bm-remember
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bm-remember/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-remember -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/basicmachines-co/basic-memory/tree/HEAD/plugins/claude-code/skills/bm-remember/SKILL.md

## When to use it
- 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
- 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

## Similar
- [remember](https://affpapa.org/en/nevibecode/skills/rohitg00-remember.md) — skill · 15000 installs
- [memory-metadata-search](https://affpapa.org/en/nevibecode/skills/basicmachines-co-memory-metadata-search.md) — skill · 564 installs
- [memory-ingest](https://affpapa.org/en/nevibecode/skills/basicmachines-co-memory-ingest.md) — skill · 555 installs
- [memory](https://affpapa.org/en/nevibecode/skills/johnlindquist-memory.md) — skill · 363 installs
- [remember-interactive-programming](https://affpapa.org/en/nevibecode/skills/remember-interactive-programming.md) — skill · 9000 installs
- [Stash: Remember Everything](https://affpapa.org/en/nevibecode/mcp/stash-remember-everything.md) — MCP server

From the same set: [basicmachines-co/basic-memory](https://affpapa.org/en/nevibecode/by/basicmachines-co/basic-memory.md) — 23 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
