whatisgithub

What is codex-remote-web?

yangchao228/codex-remote-web — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A local-first web control panel that lets you start, watch, and stop Codex CLI tasks on your computer from your phone.

Mindmap

mindmap
  root((Codex Remote Web))
    What it does
      Web control panel for Codex CLI
      Phone monitors tasks
      Restricted, not full remote access
    Tech stack
      TypeScript
      Node.js
    Use cases
      Monitor tasks from phone
      Stop running tasks
      Review task history
    Audience
      Codex CLI users
    Setup
      npm install and build
      Pair phone with six digit code

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Start a Codex CLI task on your computer, then check its progress from your phone's browser.

USE CASE 2

Stop a running Codex task remotely from your phone if it goes off track.

USE CASE 3

Review past task history and replay outputs saved locally in JSONL format.

USE CASE 4

Enable LAN mode to connect from another device on the same Wi-Fi network.

What is it built with?

TypeScriptNode.js

How does it compare?

yangchao228/codex-remote-web0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires npm install and build, plus the Codex CLI already installed on the computer.

So what is it?

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.

Copy-paste prompts

Prompt 1
Walk me through installing and starting codex-remote-web on my computer.
Prompt 2
Explain how the phone pairs with the computer using the six digit code.
Prompt 3
Show me how to enable LAN mode so my phone can connect over Wi-Fi.
Prompt 4
What actions is the phone restricted from doing in this control panel?
Prompt 5
Help me configure allowed workspace directories using environment variables.

Frequently asked questions

What is codex-remote-web?

A local-first web control panel that lets you start, watch, and stop Codex CLI tasks on your computer from your phone.

What language is codex-remote-web written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

How hard is codex-remote-web to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-remote-web for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.