Codex Mobile
🚀 Run Codex Mobile Anywhere: Linux, Windows, or Termux on Android 🚀
Last verified:
What is Codex Mobile?
Codex Mobile (codexapp) is a lightweight web interface bridge that provides browser-accessible UI for OpenAI Codex app-server workflows. It allows users to run Codex from Linux, Windows, or Termux on Android and access the full Codex desktop app experience through any web browser, eliminating the need for terminal-only interaction.
Key features include one-command launch with npx codexapp, cross-platform support, built-in voice dictation with hold-to-dictate transcription, optional Telegram bot bridge for remote messaging, project export/import as ZIP files with chat history, searchable project picker, mobile-friendly drawer sidebar, and LAN-friendly remote access. The tool exposes Codex through HTTP/WebSocket to an Express + Vue UI bridge connected to the Codex App Server.
This tool is designed for developers who want Codex access on mobile devices, Linux workstations without desktop shells, remote dev boxes, headless server workflows, Android users via Termux, and anyone needing browser-based Codex interaction without global npm installation. It serves approximately 582 GitHub stars and is built with TypeScript (53.3%) and Vue (41.0%).
Codex Mobile pricing
Pricing model: Freemium
Free and open source under MIT license. No paid plans - the tool itself is completely free. Users only pay for their Codex subscription (Free tier available, ChatGPT Plus at $20/month, or Pro at $100/month for 5x more Codex usage). The codexapp bridge requires no additional cost beyond having Codex access.
Codex Mobile pros
- One-command launch with npx codexapp
- No global npm install required
- Cross-platform: Linux, Windows, Termux on Android
- Browser-first UI accessible from any device
- LAN-friendly access from other network devices
- Built-in voice dictation with transcription
- Optional Telegram bot bridge for remote messaging
- Project export as ZIP with chat JSONL history
- Project import from browser to restore work
- Works with reverse proxies and tunneling setups
- Remote/headless-friendly for server-based Codex
- Searchable project picker in new-thread flow
- Mobile-friendly drawer sidebar with swipe support
- Auto-cloudflared tunnel with QR code display
- Pinned new projects appear at top automatically
- Optimistic in-progress threads preserved on refresh
- MIT license, open source with 26 contributors
Codex Mobile cons
- Requires Node.js 18+ installation
- Needs Codex app-server environment available
- Termux requires battery optimization disabled
- Some mobile Safari CSS issues still exist
- Port conflicts possible if already in use
- Password protection must be configured manually
- Imported chats rewritten for destination environment
- No native iOS/Android app (browser-only)
Frequently asked questions about Codex Mobile
What is codexapp / codex-mobile?
codexapp is a lightweight bridge that gives you a browser-accessible UI for Codex app-server workflows. You run one command (npx codexapp), it starts a local web server on http://localhost:18923, and you open it from your browser. It provides the Codex desktop app experience exposed over web UI, cross-platform on Linux, Windows, and Termux on Android.
How do I install and run codexapp?
Run instantly with npx codexapp (no global install required). This starts a local web server. Open http://localhost:18923 in your browser. For Termux on Android: pkg update && pkg upgrade -y, then pkg install nodejs -y, then npx codexapp. Make sure Node.js 18+ is installed first.
Can I access codexapp from my phone?
Yes. Run codexapp on your machine (Linux/Windows/Termux), then open the URL from your phone's browser if on the same LAN. For iPhone/iPad, use Tailscale Serve with HTTPS: run npx codexapp --no-tunnel --port 5900, then tailscale serve --bg 5900, and open https://<your-machine>.<your-tailnet>.ts.net
How does voice dictation work?
The app has built-in hold-to-dictate voice input. Hold the dictation button, speak, and the transcription is appended to the composer draft. Requires microphone permission in your browser. This works on mobile browsers and desktop.
What is the Telegram bot bridge?
An optional feature that forwards Telegram messages into mapped Codex threads and sends assistant replies back to Telegram. Set TELEGRAM_BOT_TOKEN and TELEGRAM_ALLOWED_USER_IDS environment variables before running codexapp. Only allowlisted Telegram user IDs can use the bridge for safety. Commands include /start, /threads, /newthread, /history, /status, and /whoami
How do I export and import projects?
Export: From project or thread menus, select export project as ZIP. This includes the matching Codex chat JSONL history under .codex-project/chats/. Export streams ZIP bytes with response backpressure handling and skips generated/git-ignored folders. Import: Use the Import Project button in the browser to restore exported ZIPs. Imported chats are rewritten for the destination CODEX_HOME and project path.
Does codexapp work on Android Termux?
Yes, but requires setup: keep codexapp running in the current Termux session (do not close), disable battery optimization for Termux in Android settings, keep the persistent Termux notification enabled, and optionally run termux-wake-lock. Open the shown URL in your Android browser. If the app is killed, return to Termux and run npx codexapp again.
How do I disable the cloudflared tunnel?
Use the --no-tunnel flag: npx codexapp --no-tunnel. By default, codexapp starts cloudflared tunnel --url http://localhost:<port> and prints the tunnel URL, terminal QR code, and password together in startup output.
What if I don't want codexapp to force codex login?
Use the --no-login flag: npx codexapp --no-login. This is useful if you are using a provider or AI gateway that is already authenticated and do not want codexapp to force codex login during startup.
What programming languages is codex-mobile built with?
The project is built with TypeScript (53.3%), Vue (41.0%), JavaScript (2.1%), Shell (1.8%), and CSS (1.8%). It uses Express + Vue UI bridge architecture connecting browser HTTP/WebSocket to the Codex App Server via RPC/Bridge calls.