Bm Status
- 128 installs
- 3.6k repo stars
- Updated August 5, 2026
- basicmachines-co/basic-memory
bm-status is a Claude skill that reports the Basic Memory plugin's current state for a project as a quick diagnostic.
About
This skill reports the Basic Memory plugin's current state for a project as a quick diagnostic. A developer runs it to see the active project, capture folders, output style, recent session checkpoints, active task count, and whether the CLI is reachable. It gathers the facts and lays them out in a concise summary without over-investigating.
- Reports the Basic Memory plugin's current state for the project
- Shows active project, capture folders, output style, and recent session checkpoints
- Checks whether the Basic Memory CLI is reachable before reporting
Bm Status by the numbers
- 128 all-time installs (skills.sh)
- Ranked #1,254 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
bm-status capabilities & compatibility
- Capabilities
- bm setup · bm remember · bm share
- Use cases
- memory
- Runs
- Runs locally
- Pricing
- Free
What bm-status says it does
Show the Basic Memory plugin's current state for this project
This is a quick diagnostic — gather the facts and lay them out; don't over-investigate.
If neither is found, report that Basic Memory isn't installed or on PATH, and stop
npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-statusAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 128 |
|---|---|
| repo stars | ★ 3.6k |
| Last updated | August 5, 2026 |
| Repository | basicmachines-co/basic-memory ↗ |
What it does
Report the Basic Memory plugin's current state: active project, folders, output style, recent checkpoints, and reachability.
Who is it for?
developers checking Basic Memory plugin configuration and reachability
When should I use this skill?
when the user wants to see the Basic Memory plugin's current state for a project
What you get
a concise status summary of the plugin's project, folders, checkpoints, and reachability
- a concise plugin status summary
By the numbers
- lists up to 5 recent session checkpoints
- reports active task count
Files
Basic Memory status
Report the plugin's current state for this project, then present a concise summary. This is a quick diagnostic — gather the facts and lay them out; don't over-investigate.
Gather
1. CLI reachable? Run basic-memory --version (fall back to bm --version). If neither is found, report that Basic Memory isn't installed or on PATH, and stop — nothing else will work without it.
2. Configuration. Read .claude/settings.json (and .claude/settings.local.json if present) and report:
- From the
basicMemoryblock:primaryProject(or note none is pinned — the
default project is used), secondaryProjects (team/shared read sources), teamProjects (share targets for /basic-memory:bm-share), captureFolder (default sessions), rememberFolder (default bm-remember), and preCompactCapture mode (default extractive).
- From the root settings object (not
basicMemory): whetheroutputStyleis
basic-memory — i.e. whether the capture reflexes are on.
3. Recent checkpoints. search_notes with metadata_filters={"type": "session"}, page_size 5, scoped to primaryProject if one is set. List the most recent session checkpoints by title + permalink.
4. Active tasks. search_notes with metadata_filters={"type": "task", "status": "active"} — report just the count.
When scoping these queries to primaryProject, pass it as project, or as project_id if it's an external_id UUID (a bare UUID in project won't route).
Present
Lay it out like this (fill in real values; write "—" or a short note for anything you couldn't determine, rather than failing the whole report):
## Basic Memory status
- CLI: basic-memory <version>
- Project: <primaryProject, or "default project (not pinned)">
- Reads from (team): <secondaryProjects joined, or "none">
- Share targets: <teamProjects keys joined, or "none">
- Capture folder: <captureFolder>
- Remember folder: <rememberFolder>
- Output style: <enabled | not enabled>
- PreCompact: <mode>
- Recent checkpoints: <n>
- <title> — <permalink>
...
- Active tasks: <n>If there are no checkpoints yet, say "none yet" and remind the user that checkpoints are written automatically before context compaction (and that a primaryProject must be set for them to be written).
Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493kFAQ
What does bm-status report?
CLI version, active project, team read/share targets, capture and remember folders, output style, PreCompact mode, recent checkpoints, and active task count.
What happens if the CLI is not installed?
It reports that Basic Memory is not installed or on PATH and stops, since nothing else works without it.