Agent Runtime Lifecycle Hooks
lobehub/lobehub
Registers lifecycle hooks on an agent run to observe, mock or intervene at each step, dispatching them in the order they were registered.
Report the Basic Memory for Codex configuration, reachability, hook expectations, recent Codex checkpoints, and active tasks.
AGPL-3.0Auto-check passed
Install Bm Status
$ npx skills add basicmachines-co/basic-memory --skill bm-status -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install basicmachines-co/basic-memory bm-status --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/codex/skills/bm-status .claude/skills/bm-status && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "bm-status" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/plugins/codex/skills/bm-status into .claude/skills/bm-status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bm-status", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/basicmachines-co/basic-memory/tree/main/plugins/codex/skills/bm-statusType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add basicmachines-co/basic-memory --skill bm-status -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install basicmachines-co/basic-memory bm-status --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/codex/skills/bm-status .agents/skills/bm-status && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "bm-status" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/plugins/codex/skills/bm-status into .agents/skills/bm-status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bm-status", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add basicmachines-co/basic-memory --skill bm-status -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install basicmachines-co/basic-memory bm-status --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/codex/skills/bm-status .cursor/skills/bm-status && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "bm-status" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/plugins/codex/skills/bm-status into .cursor/skills/bm-status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bm-status", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/basicmachines-co/basic-memory.git --path plugins/codex/skills/bm-status--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add basicmachines-co/basic-memory --skill bm-status -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install basicmachines-co/basic-memory bm-status --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/codex/skills/bm-status .gemini/skills/bm-status && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "bm-status" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/plugins/codex/skills/bm-status into .gemini/skills/bm-status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bm-status", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install basicmachines-co/basic-memory bm-statusInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add basicmachines-co/basic-memory --skill bm-status -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/codex/skills/bm-status .github/skills/bm-status && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "bm-status" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/plugins/codex/skills/bm-status into .github/skills/bm-status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bm-status", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add basicmachines-co/basic-memory --skill bm-status -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install basicmachines-co/basic-memory bm-status --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/codex/skills/bm-status .opencode/skills/bm-status && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "bm-status" agent skill from https://github.com/basicmachines-co/basic-memory/tree/main/plugins/codex/skills/bm-status into .opencode/skills/bm-status/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bm-status", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
bm-status- GitHub stars
- 4.1k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 415 words
- Files
- 3 (incl. assets)
- Skills in repo
- 49
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Report the Basic Memory for Codex configuration, reachability, hook expectations, recent Codex checkpoints, and active tasks.
- Works in 5 steps: CLI reachability → Plugin config → Core hook health → …
- SKILL.md covers Gather and Present
- Calls uvx and uv
What it does
Bm Status is an agent skill from basicmachines-co/basic-memory. Report the Basic Memory for Codex configuration, reachability, hook expectations, recent Codex checkpoints, and active tasks.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including assets (for example `agents/openai.yaml`).
The repository describes itself as: AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN. The licence is AGPL-3.0.
Example prompts
- “/bm-status”
Requirements
- Python 3
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- CLI reachability
- Plugin config
- Core hook health
- Hook files and launcher visibility
- Basic Memory queries
What it can do on your machine
Read from SKILL.md and the folder at commit 6982cfc. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
uvxuv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uvx and uv, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Bm Status loads about 1.1k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 415 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from basicmachines-co/basic-memory at commit 6982cfc, republished under its AGPL-3.0 licence (© basicmachines-co). 415 words, ~1,137 tokens.
Download SKILL.mdSave it as
.claude/skills/bm-status/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- 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
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.
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, andcaptureEvents - resolve omitted Codex defaults as
rememberFolder=codex/remember, andcheckpointOnCompact=true
- read
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
- with the first available launcher, run
Hook files and launcher visibility:
- check
uv --versionin 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 foundoccurs before the Python script can emit a diagnostic - consult
../../README.mdunder "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.jsonexists if running from this repo - remind the user that Codex plugin hooks must be reviewed and trusted before they run
- check
Basic Memory queries:
- query recent
type=codex_session; whensessionProfile=coding, also querytype=coding_sessionwithrepository=<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
- query recent
Show full SKILL.md (53 more words)Show less
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 CodexList 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.
© basicmachines-co, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (assets) in plugins/codex/skills/bm-status of basicmachines-co/basic-memory.
- SKILL.md
- agents/openai.yaml
- assets/icon.svg
Open the folder on GitHubat commit 6982cfc
Compare with similar skills
Bm Status next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Bm Status this skillbasicmachines-co/basic-memory | 4.1k | — | ~1.1k | Automated safety check: Pass | AGPL-3.0 | |
| Agent Runtime Lifecycle Hookslobehub/lobehub | 83k | — | ~2.8k | Automated safety check: Pass | Custom licence | |
| Agentmemory Capture Hooksrohitg00/agentmemory | 29k | — | ~444 | Automated safety check: Pass | Apache-2.0 | |
| Crush Hook Writercharmbracelet/crush | 29k | — | ~1.8k | Automated safety check: Pass | Custom licence | |
| Hook Development for Claude Code Pluginsanthropics/claude-plugins-official | 37k | 11 repos | ~4.1k | Automated safety check: Notes | Apache-2.0 | |
| Hooksparcadei/Continuous-Claude-v3 | 3.9k | 2 repos | ~344 | Automated safety check: Pass | MIT |
Similar skills
Agentmemory Capture Hooks
rohitg00/agentmemory
Describes the lifecycle hooks in the agentmemory Claude Code plugin that record observations automatically, and what to check when observations go missing.
Crush Hook Writer
charmbracelet/crush
Helps write, debug and configure Crush hooks in crush.json that block, approve or rewrite tool calls before they run.
- Official
Hook Development for Claude Code Plugins
anthropics/claude-plugins-official
Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.
Hooks
parcadei/Continuous-Claude-v3
Hook Development Rules
Expect
millionco/expect
A skill your agent uses when editing .tsx/.jsx/.css/.html, React components, pages, routes, forms, styles, or layouts.
More from basicmachines-co/basic-memory
All 49 skills in this repocmux Settings Editor
basicmachines-co/basic-memory
Views, sets, unsets and validates cmux settings in ~/.config/cmux/cmux.json with a helper script that checks keys against the schema.
cmux Window and Pane Control
basicmachines-co/basic-memory
End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs…
Cmux Markdown Viewer Panel
basicmachines-co/basic-memory
Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists.
cmux Workspace Scoping
basicmachines-co/basic-memory
Keeps agent actions scoped to the cmux workspace and terminal that invoked it, and lays out pane and surface commands that avoid disrupting the user's own focus.
Basic Memory Repo Images
basicmachines-co/basic-memory
Produces PR, changelog and two-week retro images for the Basic Memory repository from evidence in PR bodies, saved to fixed paths under docs/assets/infographics.
Logfire Instrumentation
basicmachines-co/basic-memory
Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.
Questions about Bm Status
What does Bm Status do?
Report the Basic Memory for Codex configuration, reachability, hook expectations, recent Codex checkpoints, and active tasks. Bm Status is an agent skill from basicmachines-co/basic-memory. Report the Basic Memory for Codex configuration, reachability, hook expectations, recent Codex checkpoints, and active tasks.
How do I install Bm Status in Claude Code?
Run `npx skills add basicmachines-co/basic-memory --skill bm-status -a claude-code`. Or copy the skill folder (plugins/codex/skills/bm-status in basicmachines-co/basic-memory) into .claude/skills/bm-status in your project. Claude Code loads it when a task matches its description.
How do I install Bm Status in Codex?
Run `npx skills add basicmachines-co/basic-memory --skill bm-status -a codex`. Or copy the skill folder (plugins/codex/skills/bm-status in basicmachines-co/basic-memory) into .agents/skills/bm-status in your project. Codex loads it when a task matches its description.
Can I use Bm Status in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add basicmachines-co/basic-memory --skill bm-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bm-status, .gemini/skills/bm-status, .github/skills/bm-status and .opencode/skills/bm-status in your project.
What does Bm Status need to run?
Going by SKILL.md and its folder, Bm Status needs the command-line tools its instructions call (uvx and uv). Our summary lists: Python 3.
Does Bm Status access the network?
SKILL.md contains no URLs. Its commands use uvx and uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Bm Status safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Bm Status use?
Bm Status is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Bm Status use?
About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Bm Status?
Skills that share tags, products or a category with Bm Status: Agent Runtime Lifecycle Hooks (lobehub/lobehub, 83k stars), Agentmemory Capture Hooks (rohitg00/agentmemory, 29k stars), Crush Hook Writer (charmbracelet/crush, 29k stars) and Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 37k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Bm Status?
basicmachines-co (a GitHub organization) maintains it in basicmachines-co/basic-memory, which has 4,107 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.
Source: basicmachines-co/basic-memory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.