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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 160 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-setup/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-setup

## What it does

The skill configures Basic Memory for a project by identifying its purpose, selecting or creating a project, and setting note placement conventions. It uses the answers to choose note schemas and configure context capture. Questions already answered by the environment are skipped.

Before the interview, it checks the Basic Memory MCP server with `bm_project_list()`. Setup stops if that tool is unavailable. The server needs Basic Memory with version 1.0 `bm_*` tools; installation options are `uv tool install basic-memory --prerelease=allow` and `pip install basic-memory`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/bm-setup/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-setup
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-setup -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-setup/SKILL.md

## When to use it
- connect a project to Basic Memory
- set conventions for placing new notes
- prepare note schemas for a project

## Example prompts
- Set up Basic Memory for this project.
- Configure this project's Basic Memory mapping and note placement.
- Run `/basic-memory:bm-setup`.

## Similar
- [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
- [om-setup-agent-pipeline](https://affpapa.org/en/nevibecode/skills/om-setup-agent-pipeline.md) — skill · 4700 installs
- [project-setup](https://affpapa.org/en/nevibecode/skills/haowjy-project-setup.md) — skill · 608 installs
- [setup](https://affpapa.org/en/nevibecode/skills/haabe-setup.md) — skill · ★ 54 repo stars
- [setup-rate-limiting](https://affpapa.org/en/nevibecode/commands/buildwithclaude-community-setup-rate-limiting.md) — command · ★ 3785 repo stars

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
