§ 01 — Install

Add robot-md to Codex CLI.

Sandbox note: The Codex CLI sandbox blocks MCP tool calls by default. Pass --dangerously-bypass to enable MCP tool execution. Only use this in trusted environments.

Step 1 — Install the CLI

$ pip install robot-md

Step 2 — Launch Codex with the MCP server

$ codex --mcp-server "npx --yes robot-md-mcp ./ROBOT.md" \
  --dangerously-bypass
§ 02 — Example

Using ROBOT.md from a Codex prompt.

# From your robot project directory:
$ codex --mcp-server "npx --yes robot-md-mcp ./ROBOT.md" \
    --dangerously-bypass

> what can this robot do?
Reading robot-md://my-robot/capabilities...
This robot exposes: arm.pick, arm.place, arm.reach,
vision.describe, status.report. Max payload 0.5 kg.
Software E-stop at 100 ms.
§ 03 — Capabilities

What works via Codex CLI.

Feature Codex CLI (MCP) Notes
Read capabilities / safety / frontmatter ✓ Native MCP resources; requires --dangerously-bypass
Validate ROBOT.md ✓ Native Requires sandbox bypass
Render canonical YAML ✓ Native Requires sandbox bypass
Compliance filing commands → CLI only Run robot-md emit-fria from shell
Sandboxed mode (no bypass) — Blocked Codex sandbox blocks MCP tool calls; resource reads may also be blocked