Sources — Codex App Server: Embeddable Agent Protocol & BYO Auth

Part of codex-app-server-byo-auth/index

Primary

Codex App Server docs (learn.chatgpt.com) — the authoritative protocol documentation: transports, message schema, lifecycle, core primitives, auth modes, account/rate-limit/usage APIs
Codex GitHub repo — app-server source — open-source implementation (openai/codex/codex-rs/app-server)
Codex CLI customization docs — related client-side config
Codex logs reference (ChatGPT admin API) — Compliance Logs Platform context for clientInfo.name

Transports: stdio (default, JSONL), websocket (ws://IP:PORT, experimental + unsupported for prod), unix://, off
Auth modes (account/login/start): chatgpt (browser flow), chatgptDeviceCode (device-code flow), chatgptAuthTokens (experimental — host-owned tokens), apiKey, plus Bedrock (amazonBedrock)
Core methods: initialize, thread/start|resume|fork|read|list|archive|delete, turn/start|steer|interrupt, command/exec, review/start, account/read, account/rateLimits/read, account/usage/read, account/sendAddCreditsNudgeEmail
Bindings: codex app-server generate-ts and generate-json-schema produce exact per-version schemas

Workspace note: RESEARCH/CODEX_APP_SERVER.md — first-pass research with the full caveat set
Vault topic: durable-agent-runtime — harness libraries family (nanocodex, Codex, pi), code-as-tool-interface
OpenClaw — community tool that routes users' ChatGPT subscriptions through a Codex-shaped client (BYO-ChatGPT precedent)
Anthropic's ban of the Claude-equivalent BYO-subscription pattern — the gray-area precedent