bm-setup — Claude Code skill: setup and installation
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.
AGPL-3.0 160 installs ★ 4,660 updated 2026-11-16
npx skills add basicmachines-co/basic-memory --skill bm-setup -a claude-codeWhat bm-setup 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.
What it helps with
- connect a project to Basic Memory
- set conventions for placing new notes
- prepare note schemas for a project
Example prompts for the agent
- Set up Basic Memory for this project.
- Configure this project's Basic Memory mapping and note placement.
- Run
/basic-memory:bm-setup.
How to install bm-setup
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-setup -a claude-code2Manually: put the files in place
~/.claude/skills/bm-setup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bm-setup/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-setup -a codex2Manually: put the files in place
.agents/skills/bm-setup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-setup -a cursor2Manually: put the files in place
.cursor/skills/bm-setup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory plugins/claude-code/skills/bm-setup2Manually: put the files in place
.github/skills/bm-setup/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-setup -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory --path plugins/claude-code/skills/bm-setupManually: put the files in place
.devin/skills/bm-setup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-setup -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-setup
How do I install bm-setup in Claude Code?
Run npx skills add basicmachines-co/basic-memory --skill bm-setup -a claude-code. The skill file is placed at ~/.claude/skills/bm-setup/SKILL.md.
What does bm-setup do?
It interviews the user to connect a project to Basic Memory and set note placement conventions. It also configures schemas and context capture.
What does bm-setup need to run?
It requires a connected Basic Memory MCP server with version 1.0 bm_* tools. Install Basic Memory with uv tool install basic-memory --prerelease=allow or pip install basic-memory.