{"id":47608532,"url":"https://github.com/friuns2/codexui","last_synced_at":"2026-05-13T02:05:17.078Z","repository":{"id":339773468,"uuid":"1163098162","full_name":"friuns2/codexUI","owner":"friuns2","description":"🚀 Run Codex App UI Anywhere: Linux, Windows, or Termux on Android 🚀","archived":false,"fork":false,"pushed_at":"2026-05-09T01:46:10.000Z","size":4945,"stargazers_count":428,"open_issues_count":16,"forks_count":86,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-05-09T02:26:11.612Z","etag":null,"topics":["aarch64","ai-agents","ai-assistant","ai-coding-agent","android","android-app","anyclaw","codex","codex-gui","codex-ui","kotlin","mobile","nodejs","openai","openclaw","rust","termux","vuejs","webview"],"latest_commit_sha":null,"homepage":"https://friuns2.github.io/codexUI/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"pavel-voronin/codex-web-local","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/friuns2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"friuns2","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2026-02-21T04:57:22.000Z","updated_at":"2026-05-09T02:18:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/friuns2/codexUI","commit_stats":null,"previous_names":["friuns2/codex-app-android","friuns2/codex-web-local"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/friuns2/codexUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friuns2%2FcodexUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friuns2%2FcodexUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friuns2%2FcodexUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friuns2%2FcodexUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/friuns2","download_url":"https://codeload.github.com/friuns2/codexUI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/friuns2%2FcodexUI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32809147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aarch64","ai-agents","ai-assistant","ai-coding-agent","android","android-app","anyclaw","codex","codex-gui","codex-ui","kotlin","mobile","nodejs","openai","openclaw","rust","termux","vuejs","webview"],"created_at":"2026-04-01T19:43:32.153Z","updated_at":"2026-05-13T02:05:17.065Z","avatar_url":"https://github.com/friuns2.png","language":"TypeScript","funding_links":["https://github.com/sponsors/friuns2"],"categories":[],"sub_categories":[],"readme":"# 🔥 codexapp\n\n### 🚀 Run Codex App UI Anywhere: Linux, Windows, or Termux on Android 🚀\n\n[![npm](https://img.shields.io/npm/v/codexapp?style=for-the-badge\u0026logo=npm\u0026logoColor=white)](https://www.npmjs.com/package/codexapp)\n[![platform](https://img.shields.io/badge/Platform-Linux%20%7C%20Windows%20%7C%20Android-blue?style=for-the-badge)](#-quick-start)\n[![node](https://img.shields.io/badge/Node-18%2B-339933?style=for-the-badge\u0026logo=node.js\u0026logoColor=white)](https://nodejs.org/)\n[![license](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](./LICENSE)\n\n\u003e **Codex UI in your browser. No drama. One command.**\n\u003e  \n\u003e **Yes, that is your Codex desktop app experience exposed over web UI. Yes, it runs cross-platform.**\n\n```text\n ██████╗ ██████╗ ██████╗ ███████╗██╗  ██╗██╗   ██╗██╗\n██╔════╝██╔═══██╗██╔══██╗██╔════╝╚██╗██╔╝██║   ██║██║\n██║     ██║   ██║██║  ██║█████╗   ╚███╔╝ ██║   ██║██║\n██║     ██║   ██║██║  ██║██╔══╝   ██╔██╗ ██║   ██║██║\n╚██████╗╚██████╔╝██████╔╝███████╗██╔╝ ██╗╚██████╔╝██║\n ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝\n```\n\n---\n\u003cimg width=\"1366\" height=\"900\" alt=\"image\" src=\"https://github.com/user-attachments/assets/1a3578ba-add8-49a2-88b4-08195a7f0140\" /\u003e\n\n## 🤯 What Is This?\n**`codexapp`** is a lightweight bridge that gives you a browser-accessible UI for Codex app-server workflows.\n\nYou run one command. It starts a local web server. You open it from your machine, your LAN, or wherever your setup allows.  \n\n**TL;DR 🧠: Codex app UI, unlocked for Linux, Windows, and Termux-powered Android setups.**\n\n---\n\n## ⚡ Quick Start\n\u003e **The main event.**\n\n```bash\n# 🔓 Run instantly (recommended)\nnpx codexapp\n\n# 🌐 Then open in browser\n# http://localhost:18923\n```\n\nBy default, `codexapp` now also starts:\n\n```bash\ncloudflared tunnel --url http://localhost:\u003cport\u003e\n```\n\nIt prints the tunnel URL, terminal QR code, and password together in startup output.  \nUse `--no-tunnel` to disable this behavior.\n\nIf you are using a provider or AI gateway that is already authenticated and do not want `codexapp` to force `codex login` during startup, use:\n\n```bash\nnpx codexapp --no-login\n```\n\n### Linux 🐧\n```bash\nnode -v   # should be 18+\nnpx codexapp\n```\n\n### Windows 🪟 (PowerShell)\n```powershell\nnode -v   # 18+\nnpx codexapp\n```\n\n### Termux (Android) 🤖\n```bash\npkg update \u0026\u0026 pkg upgrade -y\npkg install nodejs -y\nnpx codexapp\n```\n\nAndroid background requirements:\n\n1. Keep `codexapp` running in the current Termux session (do not close it).\n2. In Android settings, disable battery optimization for `Termux`.\n3. Keep the persistent Termux notification enabled so Android is less likely to kill it.\n4. Optional but recommended in Termux:\n```bash\ntermux-wake-lock\n```\n5. Open the shown URL in your Android browser. If the app is killed, return to Termux and run `npx codexapp` again.\n\n---\n\n## iPhone / iPad via Tailscale Serve\n\nIf you want to use codexUI from iPhone or iPad Safari, serving it over HTTPS is recommended.\n\nA practical private setup is to run codexUI locally and publish it inside your tailnet with Tailscale Serve:\n\n```powershell\nnpx codexapp --no-tunnel --port 5900\ntailscale serve --bg 5900\n```\n\nThen open:\n\n```text\nhttps://\u003cyour-machine\u003e.\u003cyour-tailnet\u003e.ts.net\n```\n\nThis setup worked well in practice for:\n\n- iPhone Safari access\n- Add to Home Screen\n- the built-in dictation / transcription feature in the app\n- viewing the same projects and conversations from the Windows host\n\nNotes:\n\n- Tailscale Serve keeps access private to your tailnet\n- on iOS, HTTPS / secure context appears to be important for mobile browser access and dictation\n- some minor mobile Safari CSS issues may still exist, but they do not prevent normal use\n- depending on proxying details, authentication behavior may differ from direct remote access\n- if conversations created in the web UI do not immediately appear in the Windows app, restarting the Windows app may refresh them\n\n---\n\n## ✨ Features\n\u003e **The payload.**\n\n- 🚀 One-command launch with `npx codexapp`\n- 🌍 Cross-platform support for Linux, Windows, and Termux on Android\n- 🖥️ Browser-first Codex UI flow on `http://localhost:18923`\n- 🌐 LAN-friendly access from other devices on the same network\n- 🧪 Remote/headless-friendly setup for server-based Codex usage\n- 🔌 Works with reverse proxies and tunneling setups\n- ⚡ No global install required for quick experimentation\n- 🎙️ Built-in hold-to-dictate voice input with transcription to composer draft\n- 🤖 Optional Telegram bot bridge: send messages to bot, forward into mapped thread, send assistant reply back to Telegram\n\n### Telegram Bot Bridge (Optional)\n\nSet these environment variables before starting `codexapp`:\n\n```bash\nexport TELEGRAM_BOT_TOKEN=\"\u003cyour-telegram-bot-token\u003e\"\nexport TELEGRAM_ALLOWED_USER_IDS=\"\u003cyour-telegram-user-id\u003e,\u003coptional-second-id\u003e\"\nexport TELEGRAM_DEFAULT_CWD=\"$PWD\" # optional, defaults to current working directory\nnpx codexapp\n```\n\n`TELEGRAM_ALLOWED_USER_IDS` is required for safe access. Only allowlisted Telegram user IDs can use the bridge. If no allowed user IDs are configured, incoming Telegram messages are rejected.\n\nTo find your Telegram user ID:\n\n1. Send a message to your bot.\n2. Run `curl \"https://api.telegram.org/bot\u003cyour-telegram-bot-token\u003e/getUpdates\"`.\n3. Read `message.from.id` from the returned update payload.\n\nBot commands:\n\n- `/start` show quick help and thread picker\n- `/threads` list recent threads and pick one\n- `/newthread` create and map a new Codex thread for this Telegram chat\n- `/thread \u003cthreadId\u003e` map current Telegram chat to an existing thread\n- `/current` show currently connected thread for this chat\n- `/history` show recent history for current thread\n- `/status` show bridge/mapping status\n- `/whoami` show your Telegram user/chat IDs and authorization state\n- `/help` show command reference\n\nOutgoing assistant messages are sent with Telegram `parse_mode=HTML` for formatting, with automatic plain-text fallback if HTML delivery fails.\n\n---\n\n## 🧩 Recent Product Features (from main commits)\n\u003e **Not just launch. Actual UX upgrades.**\n\n- 🗂️ Searchable project picker in new-thread flow\n- ➕ \"Create Project\" button next to \"Select folder\" with browser prompt\n- 📌 New projects get pinned to top automatically\n- 🧠 Smart default new-project name suggestion via server-side free-directory scan (`New Project (N)`)\n- 🔄 Project order persisted globally to workspace roots state\n- 🧵 Optimistic in-progress threads preserved during refresh/poll cycles\n- 📱 Mobile drawer sidebar in desktop layout (teleported overlay + swipe-friendly structure)\n- 🎛️ Skills Hub mobile-friendly spacing/toolbar layout improvements\n- 🪟 Skill detail modal tuned for mobile sheet-style behavior\n- 🧪 Skills Hub event typing fix for `SkillCard` select emit compatibility\n- 🎙️ Voice dictation flow in composer (`hold to dictate` -\u003e transcribe -\u003e append text)\n\n---\n\n## 🌍 What Can You Do With This?\n\n| 🔥 Use Case | 💥 What You Get |\n|---|---|\n| 💻 Linux workstation | Run Codex UI in browser without depending on desktop shell |\n| 🪟 Windows machine | Launch web UI and access from Chrome/Edge quickly |\n| 📱 Termux on Android | Start service in Termux and control from mobile browser |\n| 🧪 Remote dev box | Keep Codex process on server, view UI from client device |\n| 🌐 LAN sharing | Open UI from another device on same network |\n| 🧰 Headless workflows | Keep terminal + browser split for productivity |\n| 🔌 Custom routing | Put behind reverse proxy/tunnel if needed |\n| ⚡ Fast experiments | `npx` run without full global setup |\n\n---\n\n## 🖼️ Screenshots\n\n### Skills Hub\n![Skills Hub](docs/screenshots/skills-hub.png)\n\n### Chat\n![Chat](docs/screenshots/chat.png)\n\n### Mobile UI\n![Skills Hub Mobile](docs/screenshots/skills-hub-mobile.png)\n![Chat Mobile](docs/screenshots/chat-mobile.png)\n\n---\n\n## 🏗️ Architecture\n\n```text\n┌─────────────────────────────┐\n│  Browser (Desktop/Mobile)   │\n└──────────────┬──────────────┘\n               │ HTTP/WebSocket\n┌──────────────▼──────────────┐\n│         codexapp            │\n│  (Express + Vue UI bridge)  │\n└──────────────┬──────────────┘\n               │ RPC/Bridge calls\n┌──────────────▼──────────────┐\n│      Codex App Server       │\n└─────────────────────────────┘\n```\n\n---\n\n## 🎯 Requirements\n- ✅ Node.js `18+`\n- ✅ Codex app-server environment available\n- ✅ Browser access to host/port\n- ✅ Microphone permission (only for voice dictation)\n\n---\n\n## 🐛 Troubleshooting\n\n| ❌ Problem | ✅ Fix |\n|---|---|\n| Port already in use | Run on a free port or stop old process |\n| `npx` fails | Update npm/node, then retry |\n| Termux install fails | `pkg update \u0026\u0026 pkg upgrade` then reinstall `nodejs` |\n| Can’t open from other device | Check firewall, bind address, and LAN routing |\n\n---\n\n## 🤝 Contributing\nIssues and PRs are welcome.  \nBring bug reports, platform notes, and setup improvements.\n\n---\n\n## ⭐ Star This Repo\nIf you believe Codex UI should be accessible from **any machine, any OS, any screen**, star this project and share it. ⭐\n\n\u003cdiv align=\"center\"\u003e\nBuilt for speed, portability, and a little bit of chaos 😏\n\u003c/div\u003e\n\n---\n\nForked from [pavel-voronin/codex-web-local](https://github.com/pavel-voronin/codex-web-local) by Pavel Voronin.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriuns2%2Fcodexui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffriuns2%2Fcodexui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffriuns2%2Fcodexui/lists"}