This project provides a lightweight bridge to access the Codex app-server UI from any web browser, targeting developers and power users who need cross-platform accessibility. It simplifies running the Codex desktop application experience on Linux, Windows, and Termux on Android with a single command, offering a convenient, drama-free web UI.

How It Works

The codexapp acts as an Express.js-based web server that bridges browser-based HTTP/WebSocket requests to the Codex App Server via RPC calls. It leverages a Vue UI to present the Codex interface, enabling users to interact with their Codex workflows remotely, across a local network, or in headless server environments without requiring a direct desktop shell. This approach prioritizes ease of use and portability, allowing immediate experimentation via npx without global installation.

Quick Start & Requirements

The recommended way to run is via npx codexapp. This command starts a local web server, typically accessible at http://localhost:18923, and optionally configures a Cloudflare tunnel for external access.

• Prerequisites: Node.js 18+ and an available Codex app-server environment. Microphone permission is required for voice dictation.
• Platform Specifics:
  • Linux/Windows: Ensure Node.js 18+ is installed.
  • Termux (Android): Install Node.js (pkg install nodejs), update packages (pkg update && pkg upgrade -y), and run npx codexapp. For background stability, disable battery optimization for Termux, keep the persistent notification enabled, and consider termux-wake-lock.
• Optional: Use --no-tunnel to disable Cloudflare integration or --no-login to bypass forced Codex login.

Highlighted Details

• One-Command Launch: Instantly start the UI with npx codexapp.
• Cross-Platform: Supports Linux, Windows, and Termux on Android.
• Browser-First UI: Access Codex workflows directly through a web browser.
• LAN & Remote Access: Easily accessible from other devices on the same network or via tunneling.
• Voice Dictation: Built-in hold-to-dictate feature with transcription to the composer.
• Telegram Bot Bridge: Optional integration to interact with Codex threads via Telegram.
• UX Enhancements: Features include a searchable project picker, "Create Project" button, smart project name suggestions, pinned projects, and a mobile-friendly drawer sidebar.

Maintenance & Community

This project is forked from pavel-voronin/codex-web-local. No specific details on active maintainers, community channels (like Discord/Slack), or a public roadmap are provided in the README.

Licensing & Compatibility

The README does not explicitly state a license for codexUI. As it is a fork, the licensing terms of the original repository (pavel-voronin/codex-web-local) may apply, but this requires separate verification. Compatibility for commercial use or linking with closed-source projects is undetermined without a clear license.

Limitations & Caveats

Running on Android via Termux requires careful management of background processes and battery optimization settings. Minor CSS issues may persist on mobile Safari. Authentication behavior can differ when accessed through reverse proxies or tunnels. Newly created projects in the web UI might not immediately sync to the Windows desktop app without a restart. The absence of a specified license is a significant caveat for adoption decisions.