bm-status — Claude Code skill: what it does, how to install
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.
AGPL-3.0 154 installs ★ 4,660 updated 2026-11-16
npx skills add basicmachines-co/basic-memory --skill bm-status -a claude-codeWhat bm-status does
This diagnostic skill inspects your Basic Memory setup without running deep investigations. It first resolves the CLI through basic-memory, bm, or uvx runners. Next, it reads hook configurations by merging root and project settings, checking your primary project, folder paths, and session capture modes.
It then inspects core hook health to verify the shared envelope queue, archived items, and runtime versions. Finally, it searches memory to list the newest checkpoints and count active tasks.
Without an explicit primaryProject defined, session checkpoints before context compaction will fail to record.
What it helps with
- Verify whether the Basic Memory CLI is reachable in your environment
- Inspect merged configuration values between user and workspace settings
- Monitor pending envelope counts and flush timing inside the shared hook queue
- Review the latest captured session checkpoints and active task counts
Example prompts for the agent
- Show the current Basic Memory status for this project
- Run bm-status diagnostic
- Check hook inbox health and recent session checkpoints
How to install bm-status
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-status -a claude-code2Manually: put the files in place
~/.claude/skills/bm-status/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bm-status/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-status -a codex2Manually: put the files in place
.agents/skills/bm-status/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-status -a cursor2Manually: put the files in place
.cursor/skills/bm-status/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory plugins/claude-code/skills/bm-status2Manually: put the files in place
.github/skills/bm-status/SKILL.md1Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-status -a gemini-cli2Platform CLI
gemini skills install https://github.com/basicmachines-co/basic-memory --path plugins/claude-code/skills/bm-statusManually: put the files in place
.devin/skills/bm-status/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory --skill bm-status -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-status
How to install bm-status in Claude Code?
Run npx skills add basicmachines-co/basic-memory --skill bm-status -a claude-code in your terminal.
What does bm-status do?
It gathers diagnostic details on CLI availability, configuration precedence, hook inboxes, and recent memory checkpoints into a single summary.
What happens if no Basic Memory launcher resolves?
The CLI is marked unavailable, hook runtime stats are skipped, and the skill continues reporting configuration and search results.