Files

Rasmus Rygaard 39e09c289d Add a wrapper around raw response items (#5923 )

We currently have nested enums when sending raw response items in the
app-server protocol. This makes downstream schemas confusing because we
need to embed `type`-discriminated enums within each other.

This PR adds a small wrapper around the response item so we can keep the
schemas separate

2025-10-29 20:32:40 +00:00

src

[codex][app-server] resume conversation from history (#5893 )

2025-10-28 18:18:03 -07:00

tests

Add a wrapper around raw response items (#5923 )

2025-10-29 20:32:40 +00:00

Cargo.toml

Add feedback upload request handling (#5682 )

2025-10-27 05:53:39 +00:00

README.md

docs: add barebones README for codex-app-server crate (#4671 )

2025-10-03 09:26:44 -07:00

README.md

codex-app-server

codex app-server is the harness Codex uses to power rich interfaces such as the Codex VS Code extension. The message schema is currently unstable, but those who wish to build experimental UIs on top of Codex may find it valuable.

Protocol

Similar to MCP, codex app-server supports bidirectional communication, streaming JSONL over stdio. The protocol is JSON-RPC 2.0, though the "jsonrpc":"2.0" header is omitted.

Message Schema

Currently, you can dump a TypeScript version of the schema using codex generate-ts. It is specific to the version of Codex you used to run generate-ts, so the two are guaranteed to be compatible.

codex generate-ts --out DIR