yangchao228/codex-remote-web

Codex CLI Remote Control is a local-first web control panel that lets you monitor and manage an AI coding tool called Codex CLI running on your computer, from your phone's browser, without giving your phone full access to the machine. The problem it solves is simple: once you start a Codex task on your computer, you might want to step away and check on it from your phone, see if it finished, view its output, or stop it if needed, all without exposing your entire computer to the network. This project focuses on that narrow set of actions rather than acting as a general remote access tool. When you start the server on your computer, it prints a pairing address and a six digit code. You open that address in your phone's browser and enter the code to connect. From there you can pick a working directory from a pre-approved list, submit a task, watch the output stream in real time, and stop the task if necessary. You can also browse recent task history and replay past outputs. All task records are saved locally in JSONL format on your computer, and nothing is sent to the cloud. The design is intentionally restrictive by default. The phone cannot run arbitrary shell commands, read files from the computer, or pass environment variables, and it can only pick from an allowed list of working directories. Local-only access is the default, and LAN mode, which lets your phone connect from elsewhere on the same Wi-Fi network, must be explicitly turned on. The project is written in TypeScript, licensed under MIT, and the README describes it as an early MVP that already covers type checking, unit tests, and smoke tests against a real Codex CLI and LAN mode.