bm-status
Show the Basic Memory plugin's current state for this project — active project, capture folders, output style, recent session checkpoints, and whether Basic Memory is reachable.
How do I install this agent skill?
npx skills add https://github.com/basicmachines-co/basic-memory --skill bm-statusIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a diagnostic utility for the Basic Memory plugin that reports on the plugin's configuration and operational state. It performs version checks on the plugin's CLI tools and reads local settings files to provide a status summary to the user. No suspicious or malicious patterns were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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.
When no project is pinned, discover projects with bm_project_list()
and pass the selected project's external ID as project on note/search calls.
With several addressable projects, these calls require an explicit scope even
when a default is configured.
Gather
-
CLI reachable? Run
basic-memory --version, thenbm --version, thenuvx --prerelease=allow basic-memory --version. If no launcher resolves, report the CLI status as unavailable and continue with MCP/config checks. The plugin hooks can still use their uv-managed environment. -
Configuration. Read the
basicMemoryblock with the hooks' precedence. For the user-level base, appendsettings.jsonto the literal value ofCLAUDE_CONFIG_DIRwhen that environment variable is present; do not trim it, expand~, or treat an empty value as unset. Use~/.claude/settings.jsononly when the variable is absent. Then the project's.claude/settings.jsonand.claude/settings.local.jsonoverride per key. Report the result, noting when a value comes from the user-level block versus the project:- From the
basicMemoryblock:primaryProject(or note none is pinned — the listed default or sole project is selected explicitly),secondaryProjects(team/shared read sources),teamProjects(share targets for/basic-memory:bm-share),captureFolder(defaultsessions),rememberFolder(defaultbm-remember),preCompactCapturemode (defaultextractive),sessionProfile(defaultgeneral),repository(coding profile only),captureEvents(defaulttrue). - From the root settings object (not
basicMemory): whetheroutputStyleisbasic-memory— i.e. whether the capture reflexes are on.
- From the
-
Core hook health. With the first available launcher, run
basic-memory hook status --harness claude --project-dir <project-root>. Report its shared inbox path, pending envelopes, archived envelopes, pending checkpoint requests, last flush, settings state, resolved primary project, capture state, capture folder, Basic Memory version, and uv version. Inbox counts are global across supported harnesses; do not attribute a backlog solely to Claude. Treat this command's settings resolution as canonical for hook behavior; if it disagrees with the manually merged config, show the mismatch. If no launcher resolves, mark these fields unavailable and continue. -
Recent checkpoints.
bm_searchwithfilters={"type": "session"},page_size5, scoped toprimaryProjectif one is set. WhensessionProfileiscoding, also queryfilters={"type": "coding_session", "repository": "<configured repository>"}, then merge, deduplicate, sort newest first, and keep the newest five. List them by title + permalink. -
Active tasks.
bm_searchwithfilters={"type": "task", "status": "active"}— report just the count.
When scoping these queries to primaryProject, pass it as project, including
when it is an external_id UUID.
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 "discovered 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>
- Session profile: <general | coding>
- Repository: <owner/name or none>
- Event capture: <enabled | disabled>
- Shared hook inbox: <path or unavailable>
- Shared pending envelopes: <count or unavailable>
- Shared archived envelopes: <count or unavailable>
- Pending checkpoint requests: <count or unavailable>
- Last flush: <timestamp, never, or unavailable>
- Hook runtime: basic-memory <version>; uv <version or missing>
- Recent checkpoints: <n across session and coding_session>
- <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).
Warn when event capture is enabled and pending envelopes are accumulating or the
last flush is never, while noting that another harness may contribute to the
shared counts. Do not warn about an empty inbox when capture is disabled.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/basicmachines-co/basic-memory/bm-status">View bm-status on skillZs</a>