LLM.coPrivate, self-hosted LLM deployments
Legal AI infrastructure for firms
AI RFP discovery and response drafting
Automatic.coBusiness process automation
Secure AI virtual data roomscodex-mobile
codex-mobile is a lightweight Node.js web bridge that exposes a Codex AI assistant UI in the browser, running on Linux, Windows, or Android (via Termux). It provides one-command setup with optional Cloudflare tunneling, voice dictation, project import/export, and an optional Telegram bot bridge for chat integration.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | friuns2/codex-mobile |
| Owner | friuns2 |
| Primary language | TypeScript |
| License | MIT — OSI-approved |
| Stars | 751 |
| Forks | 147 |
| Open issues | 28 |
| Latest release | v514 (2026-05-17) |
| Last updated | 2026-05-26 |
| Source | https://github.com/friuns2/codex-mobile |
What codex-mobile is
TypeScript-based Express + Vue application that acts as a gateway between browser clients and a local Codex app-server instance. Supports WebSocket communication, project ZIP streaming with backpressure handling, and optional Telegram Bot API integration for message routing into mapped Codex threads.
Get the codex-mobile source
Clone the repository and explore it locally.
git clone https://github.com/friuns2/codex-mobile.gitcd codex-mobile# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- Requires Node.js 18+ and a working Codex app-server install with valid LLM provider credentials (OpenAI, Claude, DeepSeek, Gemini, etc.). No bundled backend; assumes user has Codex environment set up.
- Default port is 18923; optional `--no-tunnel` disables Cloudflare tunnel, `--port` flag allows custom binding. Tailscale Serve recommended for private HTTPS access on mobile.
- Voice dictation requires microphone permission and browser support (tested on desktop and iOS Safari). On Android Termux, requires persistent background session and battery optimization disabled.
- Project export/import handled via ZIP streaming for large projects; imports still buffer once in browser. Chats are rewritten to destination `CODEX_HOME`, project path, and selected model provider.
- Telegram bot bridge optional; requires `TELEGRAM_BOT_TOKEN`, `TELEGRAM_ALLOWED_USER_IDS` env vars. Only allowlisted Telegram user IDs can access; bot maps messages to Codex threads.
When to avoid it — and what to weigh
- You need offline or air-gapped operation — codex-mobile requires a running Codex app-server and connectivity to upstream LLM providers (OpenAI, Claude, DeepSeek, etc.). No local-only mode is documented.
- You require production-grade security infrastructure — No detailed security audit, WAF, rate limiting, or RBAC is documented. Default tunnel uses Cloudflare; authentication relies on Codex app-server layer. Requires careful network isolation for sensitive code.
- Your team needs Windows-only or macOS desktop app experience — This is a web UI bridge, not a feature-parity replacement for native Codex desktop apps. Some UX differences and mobile Safari CSS issues are acknowledged.
- You need enterprise SLA, support, or compliance guarantees — Project is community-maintained. No commercial support, security certifications, or formal SLAs are documented. Suitable for individual or small-team use only.
License & commercial use
MIT License. Permissive OSI-approved license; allows commercial use, modification, and redistribution with no warranty and minimal attribution requirement.
MIT permits commercial use. However, note that codex-mobile itself is community-maintained with no commercial support or SLAs. If Codex app-server or upstream LLM services require commercial licenses, those must be obtained separately. Recommend legal review of entire stack (Codex app-server + LLM provider terms + codex-mobile) before commercial deployment.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Strong |
| License clarity | Clear |
| Deployment complexity | Low |
| DEV.co fit | Good |
| Assessment confidence | High |
No formal security audit documented. Default Cloudflare tunnel exposes local service to internet with printed password; suitable for personal use but not sensitive code. Codex app-server authentication layer is assumed to be in place. Running in browser via HTTP on localhost is suitable for LAN/single-device use; HTTPS (via Tailscale Serve or reverse proxy) recommended for remote access. Microphone and file upload permissions required; no explicit encryption of project data at rest.
Alternatives to consider
Codex Desktop App (native)
Official Windows/macOS desktop clients with full feature parity, native performance, and official support. Trade-off: platform-specific, requires local install, no cross-device web access.
GitHub Copilot (VS Code extension / Web)
Alternative AI coding agent with IDE integration and web access. Trade-off: different model/provider, less project-centric UI, separate auth/billing.
Cursor IDE or Windsurf
IDE-first AI coding environments with native integration. Trade-off: not browser-based, platform-specific, different UX model.
Build on codex-mobile with DEV.co software developers
Start with `npx codexapp` (requires Node.js 18+ and Codex app-server). For remote or mobile access, consider Tailscale Serve or Cloudflare tunnel. Review security requirements for your use case.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
codex-mobile FAQ
Do I need to install Codex app-server separately?
Can I use codex-mobile on iPhone without Tailscale?
Is the Telegram bot bridge required?
What happens if Codex app-server crashes?
Build it with a software development company
Pairing codex-mobile with the rest of your stack is where most ai frameworks projects stall. DEV.co is a software development agency that does the integration work — plus AI development when models are in scope.
Ready to run Codex in your browser?
Start with `npx codexapp` (requires Node.js 18+ and Codex app-server). For remote or mobile access, consider Tailscale Serve or Cloudflare tunnel. Review security requirements for your use case.