# Bm Setup

Set up Basic Memory for Codex at user or project level by mapping a Basic Memory...

- Repository: https://github.com/basicmachines-co/basic-memory (4440 stars)
- Category: Engineering
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add basicmachines-co/basic-memory --skill bm-setup -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill bm-setup -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill bm-setup -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill bm-setup -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

Set up Basic Memory for Codex at user or project level by mapping a Basic Memory project and seeding schemas.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Basic Memory for Codex Setup

Set up the current repo so Codex can orient from Basic Memory and checkpoint work
back into it. Keep the interview short, but always ask before choosing where data
will be written.

## Preconditions

Confirm Basic Memory is reachable before changing files:

1. Prefer MCP: call `bm_project(command="list")`.
2. If MCP tools are not available, run `basic-memory --version` or `bm --version`.
3. If neither works, stop and tell the user to install Basic Memory and connect the
   MCP server. The plugin bundles an `.mcp.json` that starts
   `uvx --prerelease=allow basic-memory mcp`.
4. List available projects before the interview. Include cloud/local source,
   workspace, qualified name, and project id when available.

## Interview

Ask the user to choose the project mapping. Do not infer write targets from the
repo, default project, current directory, or previous local state.

The rest: https://github.com/basicmachines-co/basic-memory/blob/HEAD/plugins/codex/skills/bm-setup/SKILL.md