Avalonia desktop client

CodexGui

CodexGui combines a typed Codex app-server transport, a multi-pane workspace shell, and rich document rendering powered by ProMarkdown.

Start with the overview Run the desktop app GitHub repository
Typed transport Workspace shell Approval flows ProMarkdown rendering

Start here

Getting Started

Clone the repository with its submodule, build the solution, and launch the client.

 Application Shell

Understand the shell layout, transport lifecycle, turn flows, and approval surfaces.

 Development

Build, package, and validate the repository and documentation site.

 ProMarkdown

Explore the separately maintained Markdown library, plugins, sample, tests, and documentation.

What you get today

Native workspace shell

Navigation, thread, conversation, detail, and terminal surfaces designed for desktop workflows.

Protocol-aware transport

Local codex app-server process transport plus remote WebSocket connections.

Turn and approval flows

Live snapshots, turn authoring, interrupts, and approval prompts integrated into the UI model.

Rich Markdown rendering

The application consumes the pinned ProMarkdown submodule through a source project reference.

Repository

  • Source code and issues: github.com/wieslawsoltes/CodexGui
  • Desktop application: src/CodexGui.App
  • App-server transport: src/CodexGui.AppServer
  • Markdown dependency: external/ProMarkdown