Native Codex workspace
CodexGui
A focused native workspace for long-running Codex collaboration.
Overview
A native Avalonia desktop client for Codex app-server with thread and approval workflows, typed stdio/WebSocket transports, and ProMarkdown-powered rich conversation rendering including Mermaid diagrams.
CodexGui turns the Codex app-server protocol into a native desktop workflow. Its typed transports keep local process and remote WebSocket sessions consistent, while the pinned ProMarkdown stack adds native rich conversation rendering and complete Mermaid support beside thread, approval, detail, and terminal surfaces.
Native Avalonia client
Threads and approvals
stdio and WebSocket transports
ProMarkdown rendering with Mermaid diagrams
Built for
Where it fits.
- Developers who want a native Codex client
- App-server integration authors
- Avalonia teams exploring extensible agent workspaces
Compatibility & status
Current host
Pinned source dependency
Supported
Tracked
In the work
Real output,
not a mockup.
Architecture
Clear layers.
Replaceable seams.
Application
Avalonia XAML and C# compose the native desktop application.
Tooling
Focused packages add diagnostics, protocol, and workspace capabilities.
Targets
Local app-server processes and remote WebSocket endpoints feed the same workspace.
Quick start
From package
to first frame.
Choose the package workflow used by your repository, then start from the smallest working example. Replace VERSION with the current stable or prerelease version shown on NuGet.
dotnet tool install --global CodexGui.App --prerelease<PackageReference Include="CodexGui.App" Version="VERSION" /><PackageVersion Include="CodexGui.App" Version="VERSION" />codexguiPackage surface
Start focused.
Compose as needed.
Source, docs, samples, and releases
The repository is the source of truth.
Use the current documentation and samples, inspect changes, report issues, or support continued open-source maintenance.