Skip to main content
skill CX Codex

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

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

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

2Manually: put the files in place

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

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

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.

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-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. CX Codex +1 155installs 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