vtcode-desktop-protocol

Versioned JSON-RPC contract used between the VT Code desktop client and its matching local vtcode desktop-server process.

The transport uses one JSON-RPC object per UTF-8 line, capped at 1 MiB. The server and client negotiate a compatible protocol range, runtime events use VersionedThreadEvent from vtcode-exec-events, and host/service queues are bounded with backpressure.

Although the contract is only consumed inside the VT Code workspace today, the crate is published to crates.io because the published vtcode binary depends on it.

The wire boundary follows the general separation used by the pinned Codex app-server protocol: clients submit typed commands, servers stream authoritative runtime events, and interaction requests receive separately correlated responses. VT Code does not depend on or assume Codex's desktop UI implementation.

See the desktop workspace guide for the method list, local launch, and packaging instructions.