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.

1. 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

1. 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

1. 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

1. 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:

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 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.