Codex UI

Codex UI is a minimal, community‑maintained web interface for the official OpenAI Codex CLI. It runs the Codex CLI under the hood and streams output to your browser through a small Node/Express bridge. Install the Codex CLI first: https://github.com/openai/codex. This project is not affiliated with OpenAI.

Screenshot

NPM Package

• Package: https://www.npmjs.com/package/codex-ui
• Quick run (no install):

npx codex-ui
# or
pnpm dlx codex-ui
# or
bunx codex-ui

• Global install:

npm i -g codex-ui
codex-ui

• Environment variables:
  • PORT — server port (default: 8000 in start:prod script)
  • CORS_ORIGIN — allowed origin for REST (frontend origin in production)

Features

• Codex sessions with live streaming
  • Start/stop sessions, cancel running tasks, approve/deny exec prompts
  • WebSocket events and SSE streaming for smooth, real‑time updates
• Smart chat editor
  • File mentions: type “@path” to search files in the project and insert paths
  • Keyboard: Ctrl/Cmd+Enter to send, Tab to send (auto‑disabled while mention popup is open)
• Session management UI
  • Sidebar with recency‑sorted sessions, status indicator, token stats
  • Compact “+ New Session” action at the bottom (dashed outline)
• Polished header
  • iOS‑style segmented control (theme‑aware) to switch Projects/Codex
  • Theme toggle (Light/Dark/Auto) with icon “A” for Auto
  • Settings menu with Exit; Exit shows a confirm modal and then cleanly shuts down all sessions and the backend
• Projects
  • List/create/update/delete projects
  • Native folder picker (macOS, Windows, Linux fallback)

License

Specify a license for the project (e.g., MIT) before publishing.

Donate

[If this project saves you time, please consider supporting it.]

Your donation helps fund:

• Maintenance and issue triage
• New features and UI polish
• CI/build minutes, hosting, and testing tools

Thank you for supporting open-source work!