bm-status ยท diff
git:20260828.8bfb0ac to git:20260908.f610687
14 added, 2 removed. Audit A to A.
---
name: bm-status
description: 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
- 4. Hook files:
+ 4. Hook files and launcher visibility:
+ - check `uv --version` in the current environment independently of CLI
+ reachability; uv is a required hook prerequisite
+ - distinguish "uv missing from this shell" from "Desktop hook runtime
+ verified"; shell success does not establish the Desktop hook process's PATH
+ - when Desktop/WSL hooks fail while TUI works, inspect the actual hook
+ launch error and PATH; `uv: command not found` occurs before the Python
+ script can emit a diagnostic
+ - consult `../../README.md` under "Troubleshooting Desktop hooks on WSL"
+ for the default-location probe and conditional symlink workaround
+ - only report Desktop hook execution as verified when startup context and a
+ post-compaction checkpoint note were observed; otherwise label it unverified
- confirm `plugins/codex/hooks/hooks.json` exists if running from this repo
- remind the user that Codex plugin hooks must be reviewed and trusted before
they run
5. Basic Memory queries:
- query recent `type=codex_session`; when
`sessionProfile=coding`, also query `type=coding_session` with
`repository=<configured repository>`, then merge, deduplicate, sort newest
first, and keep the newest five; never run an unscoped coding-session query
when the repository is missing; these are agent-authored checkpoints, while
lifecycle envelopes remain local operational trace
- active `type=task`, `status=active`
- open `type=decision`, `status=open`
## Present
Use this shape:
```text
Basic Memory for Codex
- CLI: <version or missing>
- Project: <primaryProject or default>
- Reads from: <secondaryProjects or none>
- Share targets: <teamProjects or none>
- Capture folder: <captureFolder>
- Remember folder: <rememberFolder>
- Recall timeframe: <recallTimeframe>
- Session profile: <general | coding>
- Repository: <owner/name or none>
- Checkpoint on compact: <enabled | disabled>
- Event capture: <enabled | disabled>
- Shared hook inbox: <path or unavailable>
- Shared pending envelopes: <count or unavailable>
- Shared archived envelopes: <count or unavailable>
- Last flush: <timestamp, never, or unavailable>
- - Hook runtime: basic-memory <version>; uv <version or missing>
+ - Hook runtime in this environment: basic-memory <version>; uv <version or missing>
+ - Desktop hook execution: <verified from context and checkpoint | unverified>
- Recent checkpoints: <count across coding_session and codex_session>
- Active tasks: <count>
- Open decisions: <count>
- Hooks: installed; trust review required in Codex
```
List recent checkpoints by type, title, and permalink when available. 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.