Expand description
SPDX-License-Identifier: AGPL-3.0-or-later Copyright (C) Alexander R. Croft
OpenAI Codex ACP connector profile.
Speaks JSON-RPC 2.0 over stdio NDJSON, same client shape as Cursor / Agy ACP.
Practical path: official adapter @agentclientprotocol/codex-acp (starts
Codex App Server, maps ACP ↔ Codex). Configure via CODEX_ACP_BIN or default
discovery (codex-acp → npx --yes @agentclientprotocol/codex-acp).
Host auth: existing codex login, or OPENAI_API_KEY / CODEX_API_KEY.
Session correlation identity is the ACP sessionId (explicit create/load only).
The TypeScript/Python Codex SDK and codex app-server are alternate control
planes; Monoloop folds Codex in via ACP so the shared Interpreter path applies.
Structs§
- Codex
Agent Config - How to launch the ACP server process for Codex.
- Codex
Agent Handle - Live Codex ACP process + optional session.
- Codex
Connector - Factory for Codex ACP process connections.
- Codex
Connector Error - Codex / codex connector failure.
- Codex
Connector Factory - ConnectorFactory for this profile.
- Codex
RawDump - Bounded collector for exact inbound/outbound NDJSON lines.
- Codex
Session - One Codex session on an ACP process.
- Codex
Session Config - Session create parameters (
session/new+ optional mode).
Functions§
- codex_
channel_ binding - Build a ChannelBinding for StartedRuntime / ChannelRegistry composition.