# bm-status

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 154 installs · ★ 4660 repo stars
- Author: basicmachines-co
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basicmachines-co/basic-memory/tree/HEAD/plugins/claude-code/skills/bm-status/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bm-status

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-status -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bm-status/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bm-status/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-status -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bm-status/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-status -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bm-status/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install basicmachines-co/basic-memory plugins/claude-code/skills/bm-status
```

2. **Manually: put the files in place**
- File: `.github/skills/bm-status/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-status -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/basicmachines-co/basic-memory --path plugins/claude-code/skills/bm-status
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bm-status/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add basicmachines-co/basic-memory --skill bm-status -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/basicmachines-co/basic-memory/tree/HEAD/plugins/claude-code/skills/bm-status/SKILL.md

## When to use it
- 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
- Show the current Basic Memory status for this project
- Run bm-status diagnostic
- Check hook inbox health and recent session checkpoints

## Similar
- [status](https://affpapa.org/en/nevibecode/skills/nowledge-co-status.md) — skill · 312 installs
- [platform-status](https://affpapa.org/en/nevibecode/commands/platform-status.md) — command · ★ 1198 repo stars
- [team-status](https://affpapa.org/en/nevibecode/commands/sametcelikbicak-team-status.md) — command · ★ 71 repo stars
- [gsd-health](https://affpapa.org/en/nevibecode/skills/gsd-health.md) — skill · 577 installs
- [memory-status](https://affpapa.org/en/nevibecode/skills/memory-status.md) — skill · 27 installs
- [tmux-status](https://affpapa.org/en/nevibecode/plugins/tmux-status.md) — plugin · ★ 6 repo stars

From the same set: [basicmachines-co/basic-memory](https://affpapa.org/en/nevibecode/by/basicmachines-co/basic-memory.md) — 23 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
