# Bm Checkpoint

Create an immutable Codex handoff in Basic Memory and return an exact bm-orient resume...

- 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-checkpoint -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill bm-checkpoint -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill bm-checkpoint -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill bm-checkpoint -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

Create an immutable Codex handoff in Basic Memory and return an exact bm-orient resume command.

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

# Checkpoint Codex Work

Create a durable, immutable handoff note for current Codex work. Use this when
the user asks to checkpoint, wrap up, hand off, remember the work state, or when
the post-compaction SessionStart context requests the deliberate handoff.

When no project is pinned, discover projects with `bm_project(command="list")`
and pass the selected project's external ID as `project` on note/search calls.
With several addressable projects, these calls require an explicit scope even
when a default is configured.

## Gather

Read `~/.codex/basic-memory.json`, then the nearest project
`.codex/basic-memory.json`; project keys override user keys:

- `primaryProject`, default omitted
- `captureFolder`, default `codex/<git top-level directory name>`
- `placementConventions`, optional
- `sessionProfile`, default `general`
- `repository`, required when `sessionProfile` is `coding`

Apply the `bm-writing` skill before drafting the note.

Gather repo evidence:

- the original objective that started the thread and why it mattered
- the latest user intent, including corrections or scope changes that supersede
  the original objective
- the approach taken and why it solves the problem
- the current system state and practical impact
- tradeoffs, sharp edges, useful simplifications, and intentionally parked work
- `git status --short`
- current branch
- repository root and current working directory
- current Git SHA
- current pull request number, title, URL, state, base, and head when one exists
- changed files you touched
- tests or checks actually run
- failures or skipped checks
- decisions made in this thread
- unresolved blockers
- next action
- current username, hostname, and timestamp
- host-provided `session_id`, `agent`, `codex_turn_id`, `trigger`, and `model`
  values from the checkpoint request, when present

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