bm-status

Diagnose Basic Memory plugin state including CLI, configuration, hooks, and recent checkpoints.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working with the Basic Memory plugin, it can be hard to tell whether the CLI is reachable, which project is active, whether capture hooks are healthy, or why checkpoints are not appearing. This Skill gathers all of that diagnostic state in one pass and presents a concise status report. ## Core Features & Use Cases - CLI and runtime detection: Probes basic-memory, bm, and uvx launchers to report the installed version or mark the CLI unavailable. - Configuration resolution: Merges user-level and project-level settings.json files with the hooks' precedence rules to report the active project, capture folders, output style, and session profile. - Hook health and activity checks: Runs basic-memory hook status for inbox and flush state, and queries recent session checkpoints and active tasks via search_notes. - Use Case: After setting up Basic Memory in a new repository, run the status check to confirm the primary project is pinned, event capture is enabled, and checkpoints are being written before context compaction. ## Quick Start Ask the assistant to show the Basic Memory status for this project.

Frequently Asked Questions about bm-status

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

FAQPage Schema
How do I check Basic Memory plugin status in Claude Code?▼

Invoke the bm-status skill, which probes the CLI launcher, merges user and project settings, runs the hook status command, and lists recent checkpoints and active tasks in a single formatted report.

How to verify Basic Memory CLI is installed and reachable?▼

The status check tries `basic-memory --version`, then `bm --version`, then `uvx --prerelease=allow basic-memory --version`. If none resolve, the CLI is reported unavailable while MCP and config checks continue.

Why are Basic Memory checkpoints not being written?▼

Checkpoints are written automatically before context compaction, but only when a `primaryProject` is pinned in the `basicMemory` settings block. The status report shows whether a project is pinned and lists recent session checkpoints.

Does Basic Memory status work without the CLI installed?▼

Yes. When no launcher resolves, the report marks CLI and hook fields unavailable but still evaluates MCP reachability and configuration from settings files, so you get a partial diagnostic instead of a failure.

What does a growing pending envelope count mean in Basic Memory?▼

Pending envelopes accumulate when event capture is enabled but flushes are not occurring. The inbox is shared across supported harnesses, so the backlog may come from another harness, not only Claude Code.