Skip to content

spike(harness): Integrate and test OpenAI Codex CLI as a Harness (ACP?) #554

Closed

Description

@omesser

Closing as completed

Spike acceptance is met. Codex is a shipped, Verified Harness. Nothing left on this ticket.

Acceptance Where it landed
ACP-capable vs CLI-only, with citations Comment on this issue (2026-09-08) + research via #555
Launch line + auth notes + smoked-turn checklist npx -y @agentclientprotocol/codex-acp@latest; ChatGPT / API key; probe bar
Named row (follow-on, not this spike’s ship gate) #556 merged
Fresh + resumed probe exit 0 → Verified #623 closed completed 2026-09-14; README / docs/research/alternatives.md list codex named+verified

Left open only because #556 deferred the human probe to this spike’s comment, then #623 finished that probe and nobody closed #554.

Follow-ups that are not this spike: #839 (Codex skills path), #735 (runtime deps census).

— Cursor agent (Architect), on @omesser's behalf.

Activity

  1. omesser commented on Sep 8, 2026

    @omesser
    OwnerAuthor

    Research findings (Architect synthesis)

    Full note: docs/research/codex-harness.md on PR #555 (draft).

    Verdict

    ACP-capable Harness — not CLI-only. Headless path exists via @agentclientprotocol/codex-acp (JSON-RPC stdio → spawns codex app-server). Fits ADR-0018 / ADR-0022 shape; no need to reverse “our chat surface.”

    Launch (proposed)

    npx -y @agentclientprotocol/codex-acp@latest
    

    Same escape-hatch pattern as other unsmoked rows until a smoked turn earns a named codex row (#457 bar).

    Auth

    Method Notes
    ChatGPT login Browser OAuth; cache ~/.codex/auth.json — likely reusable by subprocess
    Device code Headless-friendly beta
    API key CODEX_API_KEY / OPENAI_API_KEY — CI-friendly; may disable cloud features

    What still must be proven (do not name the row yet)

    Architect take

    Treat Codex like Grok/Copilot/Gemini in ADR-0022: reachable today via custom command; named row only after probe. Prefer API-key or pre-login machine for first smoke. Do not pass auto-approve flags. Research PR is long — merge if you want the note on main, or squash later; acceptance of #554 is the recorded answer + test plan, not shipping the row.

    Next concrete step when you want it: local smoke with probe-harness.sh + the argv above, then a follow-up issue/PR for the named row if exit 0.

    — Cursor agent (Architect), on @omesser's behalf.

  2. omesser commented on Sep 8, 2026

    @omesser
    OwnerAuthor

    #556 merged (087b55e): named codex Harness row + docs/presets/unit coverage.

    Still open for the human probe bar from the PR: AI_BUDDY_HARNESS=codex scripts/probe-harness.sh fresh + resumed (exit 0). Same for the #457 smoked-turn gate — not closing either until that lands.

    — Cursor agent (Coder), on @omesser's behalf.

  3. added this to the V1 milestone on Sep 9, 2026
  4. added
    p2Eventually: real, but nothing waits on it
    on Sep 9, 2026
  5. moved this from Todo to Done in Fidgeton Sep 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    p2Eventually: real, but nothing waits on it

    Projects

    • Status
      Done

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions