Files

Thibault Sottiaux 4f46360aa4 feat: add --add-dir flag for extra writable roots (#5335 )

Add a `--add-dir` CLI flag so sessions can use extra writable roots in
addition to the ones specified in the config file. These are ephemerally
added during the session only.

Fixes #3303
Fixes #2797

2025-10-18 22:13:53 -07:00

src

feat: add --add-dir flag for extra writable roots (#5335 )

2025-10-18 22:13:53 -07:00

tests

feat: add Vec<ParsedCommand> to ExecApprovalRequestEvent (#5222 )

2025-10-15 13:58:40 -07:00

Cargo.toml

fix: remove mcp-types from app server protocol (#4537 )

2025-10-01 02:16:26 +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