Skills

Bm Status

Report the Basic Memory for Codex configuration, reachability, hook expectations...

Install

npx skills add basicmachines-co/basic-memory --skill bm-status -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
AGPL-3.0
Context cost
Lightabout 1,096 tokens
Runs scripts
No, instructions only

What it does

Report the Basic Memory for Codex configuration, reachability, hook expectations, recent Codex checkpoints, and active tasks.

Basic Memory For Codex Status

Gather a concise diagnostic. Do not over-investigate.

Gather

  1. CLI reachability:

    • basic-memory --version
    • fallback bm --version
    • fallback uvx --prerelease=allow basic-memory --version

    Keep going if no launcher resolves. The plugin hook scripts can still use their uv-managed environment; report hook health as unavailable instead of claiming the hooks cannot work.

  2. Plugin config:

    • read ~/.codex/basic-memory.json, then the nearest project .codex/basic-memory.json; project keys override user keys
    • report the resolved primaryProject, secondaryProjects, teamProjects, captureFolder, rememberFolder, recallTimeframe, focus, sessionProfile, repository, checkpointOnCompact, and captureEvents
    • resolve omitted Codex defaults as rememberFolder=codex/remember, and checkpointOnCompact=true
  3. Core hook health:

    • with the first available launcher, run basic-memory hook status --harness codex --project-dir <repo-root>
    • report the shared inbox path, pending envelopes, archived envelopes, last flush, settings state, resolved primary project, capture state, capture folder, checkpoint-prompt state, Basic Memory version, and uv version from that command
    • inbox counts are global across supported harnesses; do not attribute a backlog solely to Codex
    • treat the command's settings resolution as canonical for hook behavior; if it disagrees with the manually read config, show the mismatch
Read the whole SKILL.md on GitHub

More in Engineering