bm-setup

Configures the Basic Memory plugin through a guided interview that seeds schemas and writes project settings.

4.0k|282|Updated Dec 2, 2024
One-click install
npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-setup-basicmachines-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bm-setup
Source: https://github.com/basicmachines-co/basic-memory/tree/main/plugins/claude-code/skills/bm-setup
Command: npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-setup-basicmachines-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a persistent memory layer for Claude Code involves many manual steps: connecting the MCP server, mapping projects, seeding note schemas, and writing configuration. This Skill replaces that with a short guided interview that infers defaults from context and applies a complete, verified configuration. ## Core Features & Use Cases - Guided configuration interview: Asks only what it cannot infer, covering project mapping, cloud/team workspaces, placement conventions, lifecycle capture, and output style. - Schema seeding: Installs session, decision, and task schemas into the chosen Basic Memory project without overwriting existing customizations. - Settings persistence and smoke test: Merges a basicMemory block into .claude/settings.json or settings.local.json, then verifies recall routing and hook health via CLI queries. - Use Case: After installing Basic Memory, run the setup once so every future session starts with a knowledge brief, automatic PreCompact checkpoints, and notes that land in the right folders. ## Quick Start Ask the assistant to set up Basic Memory for this project and answer the short interview it runs.

Frequently Asked Questions about bm-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Basic Memory in Claude Code?▼

Install the server with uv tool install basic-memory --prerelease=allow, connect it via claude mcp add, then run the setup interview. It maps a project, seeds schemas, writes the basicMemory settings block, and smoke-tests recall before finishing.

How do I connect the Basic Memory MCP server to Claude Code?▼

Run claude mcp add basic-memory -- uvx --prerelease=allow basic-memory mcp, then restart the session. The --prerelease=allow flag is required because Basic Memory depends on a FastMCP pre-release that uv otherwise skips.

Does Basic Memory setup work with cloud team workspaces?▼

Yes. The interview lists workspaces, lets you pick read-only team projects for recall (capped at six per session), and optionally configures a share target. Cloud projects must be created through a cloud-connected MCP server using workspace-qualified names or UUIDs.

Why does Basic Memory schema seeding fail on cloud projects?▼

Cloud writes corrupt schema frontmatter if the YAML block is embedded in note content, coercing it to the string '[object Object]'. Pass the schema's structured fields via the metadata parameter instead, then verify with read_note in JSON format.

What is the difference between coding and general session profiles?▼

The coding profile seeds a Coding Session schema requiring Git identity fields like repository, branch, and SHA, making checkpoints queryable. It requires confirming a repository identifier, while the general profile uses a lighter session schema without Git fields.