Skip to content

v0.2.0 リリースノート

Codex Remote Control Lab v0.2.0

v0.2.0 は phone bridge の継続利用を強化するリリースです。対象範囲は v0.1.0 から release/v0.2.0 までで、desktop と mobile から同じ Codex control surface を扱える状態に寄せています。

ハイライト

  • 既定の起動 URL は 1 つの shared bridge-managed thread に参加します。スマホと別ブラウザで同じ /?token=... URL を開いても、端末ごとに別 default bridge session を作らなくなりました。
  • phone bridge は CODEX_APP_SERVER_URL または CODEX_APP_SERVER_SOCK で既存の headless Codex app-server に接続できます。Codex app-server を LAN に直接公開せず、Remote Connection ワークフローに合わせられます。
  • 履歴同期は既定で有効です。turn 完了後に thread/read と scan-backed thread/list を呼び、Codex Desktop が reopen / refresh 後に更新済み session を見つけやすくします。
  • browser UI は Codex Desktop 風の layout、thread navigation、artifact preview、model/config/plugin/auth panel、画像添付、承認 control、live run-state 表示、テーマ切り替えを備えました。

レビュー対応による強化

  • /api/thread polling はまず thread/read を使い、必要な場合だけ thread/resume に fallback します。
  • API 側の app-server request は persistent WebSocket RPC client を再利用し、request ごとの接続作成を避けます。
  • selected thread refresh と background thread-list polling は、重複 request や同じ error の連続表示を抑えます。
  • live update 後の bridge history も最新 80 件に制限し、初期 thread load と挙動を揃えました。
  • LAN IPv4 URL を検出できない環境でも、startup notification に undefined の click URL を渡さなくなりました。

運用メモ

  • Codex app-server は 127.0.0.1 に閉じ、LAN には token-protected bridge だけを出してください。
  • startup notification は、LAN URL がある場合に token 付き bridge URL を含みます。private topic / account / Discord channel で使ってください。
  • Codex Desktop と live sync したい場合は、Desktop Remote Connection と OCdex を同じ headless app-server に向けます。通常の Desktop ローカル会話画面は private stdio app-server を使うため、外部から本文へ live injection する対象ではありません。

検証

  • npm run check
  • npm test(18 tests)
  • npm run docs:build
  • git diff --check
  • /api/info, /api/threads, /api/thread の local bridge smoke test
  • PR #2 の GitHub Actions verify

関連記事: v0.2.0 Phone Bridge Walkthrough