STEP 1712 · Codex CLI verify prep 2026-09-03

Codex CLI install 待ちの handoff-ready state

STEP 1690 v2.5 の converter + mapper を実 Codex CLI に食わせて動作確認するための prep。私で完結できる script / fixture / 手順は用意済み、藤本さんが Codex CLI install → 1 command で verify → 出力を私に共有 → 別 STEP で実測反映、という 3 phase workflow。

関連 STEP 1634 / 1639 / 1690 / 1711 / 1712 Prep artifacts: 3 fixture + 1 script Install 状態: 未 install (藤本さん scope)

Rei 側 prep · Done

私で完結できる部分は完了

Sample fixture (JSON/TOML/permissions) 3 file + verify script 1 file + 手順文書 (本 page)。藤本さんが install した瞬間から run 可能。

藤本さん scope · Waiting

Codex CLI install + 実行 + 共有

私 (Claude) は Codex CLI を install できません。藤本さんの手元で install → verify script 実行 → 出力を共有していただければ、別 STEP で実測結果を site 反映します。

Prep artifacts

Handoff-ready

Fixture · JSON

data/agent-connector-samples/sample-mcp-claude.json

Claude Code 側の .mcp.json sample。3 server (filesystem-local / brave-search / github-mcp) の典型的 MCP config。API key placeholder 付き、そのまま docker run 例も含む。

Fixture · TOML

data/agent-connector-samples/sample-mcp-codex.toml

converter で JSON → TOML 変換した Codex CLI 側の ~/.codex/config.toml sample。上記 3 server の TOML 形式 + Codex-only required = true field 例。

Fixture · JSON

data/agent-connector-samples/sample-permissions-claude.json

Claude Code settings.json permissions sample。allow[] 13 entry + deny[] 3 entry + mode: default。危険 pattern (rm -rf / sudo) を deny でブロック。

Script · tsx

scripts/agent-connector/verify-codex-cli-adapters.ts

4 phase (detect / converter roundtrip / permission mapper dry-run / Codex CLI live verify)。Codex CLI 未 install 時は Phase 4 を skip + install 手順表示、install 済なら藤本さん手動 phase の指示。

3 phase workflow

User handoff

Phase 1 · 完了 by Claude (rei-aios-ff tab)

Rei 側 prep — script + fixture + 手順

本 STEP 1712 で 4 artifact + 手順文書 (本 page) を準備。藤本さんが install した瞬間から npx tsx で run 可能な状態。

Phase 2 · 藤本さん手元 by 藤本さん

Codex CLI install → verify script run

Codex CLI install の option (どちらか):

npm install -g @openai/codex

# または OpenAI 公式手順:
curl -fsSL https://openai.com/codex/install.sh | sh

# install 確認:
codex --version

その後、rei-aios repo root で verify script を実行:

cd C:/Users/user/rei-aios
npx tsx scripts/agent-connector/verify-codex-cli-adapters.ts

Phase 1-3 は install なしでも動作します (fixture roundtrip + dry-run mapping)。Phase 4 (Codex CLI live verify) だけが install 必須。

Phase 3 · 別 STEP by Claude (別 tab or 続き)

藤本さん出力共有 → 実測結果 site 反映

藤本さんが script 出力 (特に Phase 4 の Codex CLI 実測部分) を Claude に共有すると、別 STEP で:

NONCONFORM 発見時 → converter/mapper の bug fix (v2.5.1 patch)
CONFORM 確認時 → agent-connector v2.5 の「実 Codex CLI で verify 済」 badge 追加 (別 site page or STEP 1690 v2.5 の retrospective note)
両ケース共通 → memory + notepad + coverage map で実測結果永久記録

Sample output (Codex CLI 未 install 時)

Verify script dry-run

═══ Codex CLI adapter verify prep — STEP 1712 ═══

── Phase 1: Codex CLI detection ────────────────────────────
  isAvailable: false
  error: spawn codex ENOENT

── Install 手順 (Codex CLI 未 install) ─────────────
  npm install -g @openai/codex
  Install 確認: codex --version
  Install 後 再実行: npx tsx scripts/agent-connector/verify-codex-cli-adapters.ts

── Phase 2: MCP converter roundtrip (fixture) ─────────
  [2.1] JSON → TOML: output 617 bytes, warnings 1, droppedFields 1 (type)
  [2.2] JSON → TOML → JSON roundtrip on common shape
    command preserved: ✓
    args preserved:    ✓
    env preserved:     ✓
    cwd preserved:     ✓
    droppedFields: 0 (common shape)
  [2.3] Codex TOML → Claude JSON on sample: 3 servers parsed, 1 dropped (required)

── Phase 3: Permission mapper dry-run ─────────────
  [3.1] Claude → Codex tier: sandbox_mode = workspace-write
  [3.2] Codex tier → Claude: 20 entry recovered
  [3.3] Roundtrip loss: isLossless=false (expected, conservative mapper)

── Phase 4: Codex CLI live verify ─────────
  ✗ Codex CLI 未 install。 Phase 4 skip。

── Summary ──
  Codex CLI: 未 install ✗
  Converter fixture roundtrip: 実行済
  Permission mapper dry-run: 実行済
  Live verify: skip (install 待ち)

Phase 1-3 は install なしでも動くので、藤本さんが install する前に script を試して「converter + mapper 自体は動く」ことが確認できます。Phase 4 だけが実 Codex CLI 依存です。

Honest scope

主張しないこと

本 STEP は「prep」であって「verify」ではありません。 Codex CLI 実 install → 実 config parse 試行 → 実 mapping 実行は藤本さん手元でのみ可能。私で完結する部分は「script + fixture + 手順」まで。「STEP 1712 でも Codex CLI で verify した」と誤読しないでください。
Codex CLI install を私からお願いしません。 Install の value 判断は藤本さん scope。 Rei は Rei として Codex CLI なしで動きます (STEP 1690 v2.5 converter/mapper は spec に対して test 233/233 clean = 実装完成)。実 Codex CLI verify は「retrospective validation」の value であって「必須」ではありません。
Phase 2 (converter roundtrip) は fixture のみ。 STEP 1690 の test/step1690-*.ts §6-9 で既に検証済みの 4 field lossless roundtrip を re-verify するだけ。実 Codex CLI の parse 挙動 (TOML 拡張 syntax、 error message 形式など) は Phase 4 でのみ判明します。
Phase 3 (permission mapper dry-run) は sandbox 実行なし。 mapping の結果を表示するだけで、実際に sandbox で「Codex tier を run したらどうなるか」の live 実行は含めません (destructive avoid)。
Phase 4 で NONCONFORM が発見された場合の対応は別 STEP。 converter/mapper に bug が見つかった場合の fix (v2.5.1 patch) は「実測 → 藤本さん共有 → 私が反映」の 3 phase 経由で行います。本 STEP では bug 予測 + preemptive fix はしません (measure-first discipline)。
Codex CLI 側の実装が Rei snapshot 時点 (2026-09-01, STEP 1634 documented) から drift した可能性あり。 実際の Codex CLI が sample TOML を reject した場合、私の Codex CLI spec 理解が古い可能性 = fixture 側の更新が必要。これも Phase 4 実測で判明。

Codex CLI install 待ち の handoff-ready state