@nervmor/codexui 1.0.0

package/LICENSE

@@ -0,0 +1,11 @@
+MIT License
+
+Copyright 2026 Pavel Voronin, Igor Levochkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+

package/README.md

@@ -0,0 +1,195 @@
+# 🔥 @nervmor/codexui
+
+### 🚀 Run Codex App UI Anywhere: Linux, Windows, or Termux on Android 🚀
+
+[![npm](https://img.shields.io/npm/v/%40nervmor%2Fcodexui?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/@nervmor/codexui)
+[![platform](https://img.shields.io/badge/Platform-Linux%20%7C%20Windows%20%7C%20Android-blue?style=for-the-badge)](#-quick-start)
+[![node](https://img.shields.io/badge/Node-18%2B-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
+[![license](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](./LICENSE)
+
+> **Codex UI in your browser. No drama. One command.**
+>  
+> **Yes, that is your Codex desktop app experience exposed over web UI. Yes, it runs cross-platform.**
+
+```text
+ ██████╗ ██████╗ ██████╗ ███████╗██╗  ██╗██╗   ██╗██╗
+██╔════╝██╔═══██╗██╔══██╗██╔════╝╚██╗██╔╝██║   ██║██║
+██║     ██║   ██║██║  ██║█████╗   ╚███╔╝ ██║   ██║██║
+██║     ██║   ██║██║  ██║██╔══╝   ██╔██╗ ██║   ██║██║
+╚██████╗╚██████╔╝██████╔╝███████╗██╔╝ ██╗╚██████╔╝██║
+ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝
+```
+
+---
+
+## 🤯 What Is This?
+**`@nervmor/codexui`** is a lightweight bridge that gives you a browser-accessible UI for Codex app-server workflows.
+
+You run one command. It starts a local web server. You open it from your machine, your LAN, or wherever your setup allows.  
+
+**TL;DR 🧠: Codex app UI, unlocked for Linux, Windows, and Termux-powered Android setups.**
+
+---
+
+## ⚡ Quick Start
+> **The main event.**
+
+```bash
+# 🔓 Run instantly (recommended)
+npx @nervmor/codexui
+
+# 🌐 Then open in browser
+# http://localhost:18923
+```
+
+By default, `@nervmor/codexui` now also starts:
+
+```bash
+cloudflared tunnel --url http://localhost:<port>
+```
+
+It prints the tunnel URL, terminal QR code, and password together in startup output.  
+Use `--no-tunnel` to disable this behavior.
+
+### Linux 🐧
+```bash
+node -v   # should be 18+
+npx @nervmor/codexui
+```
+
+### Windows 🪟 (PowerShell)
+```powershell
+node -v   # 18+
+npx @nervmor/codexui
+```
+
+### Termux (Android) 🤖
+```bash
+pkg update && pkg upgrade -y
+pkg install nodejs -y
+npx @nervmor/codexui
+```
+
+Android background requirements:
+
+1. Keep the `codexui` session running in the current Termux session (do not close it).
+2. In Android settings, disable battery optimization for `Termux`.
+3. Keep the persistent Termux notification enabled so Android is less likely to kill it.
+4. Optional but recommended in Termux:
+```bash
+termux-wake-lock
+```
+5. Open the shown URL in your Android browser. If the app is killed, return to Termux and run `npx @nervmor/codexui` again.
+
+---
+
+## ✨ Features
+> **The payload.**
+
+- 🚀 One-command launch with `npx @nervmor/codexui`
+- 🌍 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
+
+---
+
+## 🧩 Recent Product Features (from main commits)
+> **Not just launch. Actual UX upgrades.**
+
+- 🗂️ Searchable project picker in new-thread flow
+- ➕ Inline "Add new project" input inside picker (no 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)
+- 🎛️ Skills Hub mobile-friendly spacing/toolbar layout improvements
+- 🪟 Skill detail modal tuned for mobile sheet-style behavior
+- 🧪 Skills Hub event typing fix for `SkillCard` select emit compatibility
+- 🎙️ 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 |
+
+---
+
+## 🖼️ Screenshots
+
+### Skills Hub
+![Skills Hub](docs/screenshots/skills-hub.png)
+
+### Chat
+![Chat](docs/screenshots/chat.png)
+
+### Mobile UI
+![Skills Hub Mobile](docs/screenshots/skills-hub-mobile.png)
+![Chat Mobile](docs/screenshots/chat-mobile.png)
+
+---
+
+## 🏗️ Architecture
+
+```text
+┌─────────────────────────────┐
+│  Browser (Desktop/Mobile)   │
+└──────────────┬──────────────┘
+               │ HTTP/WebSocket
+┌──────────────▼──────────────┐
+│         codexui             │
+│  (Express + Vue UI bridge)  │
+└──────────────┬──────────────┘
+               │ RPC/Bridge calls
+┌──────────────▼──────────────┐
+│      Codex App Server       │
+└─────────────────────────────┘
+```
+
+---
+
+## 🎯 Requirements
+- ✅ Node.js `18+`
+- ✅ Codex app-server environment available
+- ✅ Browser access to host/port
+- ✅ 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. ⭐
+
+<div align="center">
+Built for speed, portability, and a little bit of chaos 😏
+</div>