CodexGui is a native Avalonia desktop client for the Codex app-server protocol. It combines a typed transport layer, a multi-pane workspace shell, and a reusable markdown stack for rich conversation, diff, and document experiences.
See the project layout, core capabilities, and how the desktop client fits the Codex workflow.
Running the AppBuild the solution, launch the Avalonia desktop shell, and connect to an app-server endpoint.
Application ShellUnderstand the shell layout, transport lifecycle, turn flows, and approval surfaces.
Markdown StackExplore the reusable markdown subsystem, plugin projects, and rich rendering building blocks.
Use the overview and run instructions to get the desktop client working quickly.
Application ShellDive into the transport orchestration, shell layout, and interaction model.
Markdown StackReview the renderer, editor integration, and extension/plugin ecosystem.
DevelopmentBuild, test, and validate the repository, including the Lunet docs pipeline.
ReferenceBrowse repository structure, roadmap direction, and supporting project references.
Navigation rail, thread list, center conversation stream, detail pane, and terminal strip designed for desktop workflows.
Local codex app-server process transport plus remote ws:// and wss:// connections with lifecycle and interrupt handling.
Initialize handshake, live snapshots, turn authoring, interrupts, and approval prompts integrated into the UI model.
Shared rendering and editing infrastructure with plugin projects for alerts, math, Mermaid, figures, footers, syntax highlighting, and more.
src/CodexGui.Appsrc/CodexGui.AppServersrc/CodexGui.Markdown*docs/