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-backedthread/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/threadpolling はまず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
stdioapp-server を使うため、外部から本文へ live injection する対象ではありません。
検証
npm run checknpm test(18 tests)npm run docs:buildgit diff --check/api/info,/api/threads,/api/threadの local bridge smoke test- PR #2 の GitHub Actions
verify