Skip to main content
skill CX Codex

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

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

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

2Manually: put the files in place

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

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

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.

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