OpenParable
Skip to content
← Back to skills

Bm Orient

Productivity
bm-orient

Bm Orient is an Agent Skill for productivity published in the basicmachines-co/basic-memory repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Orient Codex from Basic Memory before substantial repo work by reading active tasks, decisions, recent Codex checkpoints, and repo conventions.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/basicmachines-co/basic-memory/blob/HEAD/plugins/codex/skills/bm-orient/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/bm-orient, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Orient From Basic Memory

Use this before substantial work in a repo, before resuming an old thread, or when the user asks where things stand.

Steps

  1. Read .codex/basic-memory.json if present. Use primaryProject, secondaryProjects, recallTimeframe, and placementConventions. If the file is missing, continue against the default Basic Memory project and mention that setup has not been run.

  2. Query the primary project:

    • active tasks: type=task, status=active
    • open decisions: type=decision, status=open
    • recent Codex sessions: type=codex_session, after recallTimeframe
    • recent generic sessions only if no Codex sessions are found
  3. Query configured secondaryProjects read-only for open decisions. Do not write to shared projects during orientation.

  4. Read the highest-signal hits before summarizing. Prefer notes that match the current repo, named route, issue, branch, or file path.

  5. Present a compact orientation:

    • active work
    • decisions that constrain the next move
    • recent checkpoint cursor
    • likely next action
    • any missing setup or ambiguous project mapping

Keep the summary evidence-backed. Include permalinks for notes you rely on.