CodexUI

CodexUI is a native Qt 6 Widgets graphical Codex client built on AISuite's public Codex frontend C++ SDK. The UI shell implements the Figma v2 workbench (node 4:2).

CodexUI
    |
    | AISuite public frontend C++ SDK
    v
codex-backend
    |
    v
codex app-server

CodexUI connects automatically to the local codex-backend Unix frontend socket through Qt and delegates authentication, protocol handling, and state synchronization to AISuite's public frontend SDK. The sidebar displays real synchronized threads, and the center work area renders the selected thread's real turns, messages, semantic items, activity, token usage, and failures from the current immutable frontend State. The composer can lazily acquire controller ownership, create a thread, start or continue a real turn, and interrupt the selected active turn. Live output continues to arrive entirely through AISuite's immutable State projection.

Sending on a persisted thread automatically resumes it in the running Codex App Server before starting the turn; selecting a thread still performs only the read-side synchronization needed to render it.

CodexUI also presents real command and file-change approvals and typed user-input requests from AISuite's canonical pending-request collection. A real attention count opens the compact request dialog, responses acquire controller ownership only when submitted, and requests remain visible until a subsequent immutable State update removes or changes them.

The Inspector follows the selected thread and renders its latest plan, subagent/collaboration activity, reported file changes, and compact factual thread/turn/synchronization information from public typed AISuite projections. Unavailable or truncated fields remain visibly absent rather than being reconstructed from protocol JSON or the local filesystem.

Attachments, advanced thread management, and settings/persistence remain outside the current interactive core.

Build

Qt 6 Widgets, Qt 6 Network, and an installed AISuite package that exports its public Codex frontend client are required.

cmake -S . -B build -G Ninja
cmake --build build --parallel 28

License

CodexUI is available under the LGPL-3.0-or-later OR MIT dual license.