The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
the built-in dictation / transcription feature in the app
viewing the same projects and conversations from the Windows host
Notes:
Tailscale Serve keeps access private to your tailnet
on iOS, HTTPS / secure context appears to be important for mobile browser access and dictation
some minor mobile Safari CSS issues may still exist, but they do not prevent normal use
depending on proxying details, authentication behavior may differ from direct remote access
if conversations created in the web UI do not immediately appear in the Windows app, restarting the Windows app may refresh them
✨ Features
The payload.
🚀 One-command launch with npx codexapp
🌍 Cross-platform support for Linux, Windows, and Termux on Android
🖥️ Browser-first Codex UI flow on http://localhost:18923
🌐 LAN-friendly access from other devices on the same network
🧪 Remote/headless-friendly setup for server-based Codex usage
🔌 Works with reverse proxies and tunneling setups
⚡ No global install required for quick experimentation
🎙️ Built-in hold-to-dictate voice input with transcription to composer draft
🤖 Optional Telegram bot bridge: send messages to bot, forward into mapped thread, send assistant reply back to Telegram
Telegram Bot Bridge (Optional)
Set these environment variables before starting codexapp:
export TELEGRAM_BOT_TOKEN="<your-telegram-bot-token>"
export TELEGRAM_ALLOWED_USER_IDS="<your-telegram-user-id>,<optional-second-id>"
export TELEGRAM_DEFAULT_CWD="$PWD" # optional, defaults to current working directory
npx codexapp
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.
To find your Telegram user ID:
Send a message to your bot.
Run curl "https://api.telegram.org/bot<your-telegram-bot-token>/getUpdates".
Read message.from.id from the returned update payload.
Bot commands:
/start show quick help and thread picker
/threads list recent threads and pick one
/newthread create and map a new Codex thread for this Telegram chat
/thread <threadId> map current Telegram chat to an existing thread
/current show currently connected thread for this chat
/history show recent history for current thread
/status show bridge/mapping status
/whoami show your Telegram user/chat IDs and authorization state
/help show command reference
Outgoing assistant messages are sent with Telegram parse_mode=HTML for formatting, with automatic plain-text fallback if HTML delivery fails.
🧩 Recent Product Features (from main commits)
Not just launch. Actual UX upgrades.
🗂️ Searchable project picker in new-thread flow
➕ "Create Project" button next to "Select folder" with browser prompt
📌 New projects get pinned to top automatically
🧠 Smart default new-project name suggestion via server-side free-directory scan (New Project (N))
🔄 Project order persisted globally to workspace roots state
🧵 Optimistic in-progress threads preserved during refresh/poll cycles
📱 Mobile drawer sidebar in desktop layout (teleported overlay + swipe-friendly structure)
🎙️ Voice dictation flow in composer (hold to dictate -> transcribe -> append text)
🌍 What Can You Do With This?
| 🔥 Use Case | 💥 What You Get |
|---|---|
| 💻 Linux workstation | Run Codex UI in browser without depending on desktop shell |
| 🪟 Windows machine | Launch web UI and access from Chrome/Edge quickly |
| 📱 Termux on Android | Start service in Termux and control from mobile browser |
| 🧪 Remote dev box | Keep Codex process on server, view UI from client device |
| 🌐 LAN sharing | Open UI from another device on same network |
| 🧰 Headless workflows | Keep terminal + browser split for productivity |
| 🔌 Custom routing | Put behind reverse proxy/tunnel if needed |
| ⚡ Fast experiments | npx run without full global setup |
✅ Microphone permission (only for voice dictation)
🐛 Troubleshooting
| ❌ Problem | ✅ Fix |
|---|---|
| Port already in use | Run on a free port or stop old process |
| npx fails | Update npm/node, then retry |
| Termux install fails | pkg update && pkg upgrade then reinstall nodejs |
| Can’t open from other device | Check firewall, bind address, and LAN routing |
🤝 Contributing
Issues and PRs are welcome.
Bring bug reports, platform notes, and setup improvements.
⭐ Star This Repo
If you believe Codex UI should be accessible from any machine, any OS, any screen, star this project and share it. ⭐
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
