Codex Remote Control Labデスクトップの Codex セッションをスマホから操作

Codex 本体は localhost に閉じ、token 付き LAN bridge だけを公開。PC とスマホで同じ thread を継続できます。

Bridge を起動

安全設計

localhost 優先

Codex app-server は 127.0.0.1 に bind し、LAN に出すのは Node bridge だけです。

スマホリモコン

スマホのブラウザから、デスクトップ側で動いている Codex app-server を操作できます。

セッション同期

bridge-managed thread を PC とスマホで共有し、同じ Codex 作業をどちらの端末からでも継続できます。

公開安全

token、upload、Codex home、log、session database は Git に入れない前提で整理しています。

Codex Remote Control Lab

Quick Start

bash

npm ci
npm run phone

Mac に表示された URL を、同じ Wi-Fi/LAN 上のスマホや別ブラウザで開きます。スマホからデスクトップの Codex セッションを操作でき、別ブラウザでも同じ bridge-managed thread を resume できます。

既定では page、API、WebSocket に token が必要です。host だけで UI を確認する場合は PHONE_DEBUG_NO_TOKEN=1 npm run phone を使うと、bridge は 127.0.0.1 に bind され、token なし URL を表示します。信頼できる private LAN に token なしで出す場合だけ、PHONE_DEBUG_BIND=lan を追加します。

protocol だけを確認する場合は、別 terminal で app-server と probe を動かします。