# Bm Status

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

- Repository: https://github.com/basicmachines-co/basic-memory (4440 stars)
- Category: Engineering
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add basicmachines-co/basic-memory --skill bm-status -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill bm-status -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill bm-status -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill bm-status -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/basicmachines-co/basic-memory/blob/HEAD/plugins/codex/skills/bm-status/SKILL.md