0xcaff/codex-web

What is codex‑web?

codex‑web は、Codex Desktop AIエージェントプラットフォームのブラウザUIを提供する軽量なNode.jsラッパーです。バックエンドは信頼できるマシン上で実行されるため、どのデバイスからでもエージェントを制御できます。

実際には、以下の通りです：

ブラウザUIを提供するNode.jsサーバーを起動します。
そのUIをcodex CLI（Codex Desktopエージェントプラットフォームのコマンドラインクライアント）に接続します。
重い処理（ファイルアクセス、認証情報の使用、コマンド実行など）は、ホストマシン上で実行され、ブラウザ内では行われません。

結果として、デスクトップ専用の体験を、スマートフォンやタブレット、またはリモートコンピュータからも、フルデスクトップUIをインストールせずに利用可能にします。

Why does it exist?

元々のCodex Desktopはターミナルウィンドウで動作するため、長時間実行するエージェントや、デスクトップクライアントがインストールされていないデバイスでの利用には不便です。HTTP経由でUIを公開することで、以下が可能になります：

ラップトップを閉じた後もエージェントを継続して実行できます。
ブラウザを持つ任意のデバイスから再接続できます。
バックエンドを信頼できるマシン上に保ち、ローカルファイルや認証情報、サインイン済みのOpenAIアカウントへのアクセスを維持できます。

How to get it running

前提条件 – ホストマシンに codex CLIがインストールされており、codex login --device-auth でログイン済みである必要があります。

サーバーの起動 – npx または Nix を使って起動できます：

npx --yes github:0xcaff/codex-web   # 1行で、インストール不要
# または
nix run github:0xcaff/codex-web

ブラウザで http://127.0.0.1:8214（または設定したアドレス）を開きます。

高度な設定：外部アプリサーバーへのプロキシ

codex‑web のクラッシュがエージェントプロセスを停止しないように、アプリサーバーを別途起動し、codex_remote_proxy スクリプトを使ってUnixソケットに接続できます。READMEには正確なコマンドシーケンスが記載されています。

Security considerations

Web UIはホストユーザーが実行できるすべてのコマンドを発行できるため、サーバーにアクセス可能なネットワーク上のすべてのピアがホストを完全に制御できることに注意してください。推奨事項：

信頼できるネットワークでのみサーバーを実行する。
VPN、WireGuard、Tailscale、またはSSHトンネルの背後に配置する。
より厳格なアクセス制御が必要な場合は、外部のリバースプロキシや認証ゲートウェイを導入する。

Current features

macOS、Linux、および codex CLI + Nodeが動作するすべてのプラットフォームで動作。
ブラウザベースのUI（軽量ラッパー、更新が迅速）。
Codex Desktopの機能をサポート：
- サブエージェント – 他のエージェントを起動できるエージェント。
- インライン画像 – UI内に直接表示される視覚的出力。
- エディタサイドパネル – ブラウザビューに埋め込まれたコードエディタ。
- 音声認識 – 音声からテキストへの変換統合。

Roadmap (what’s missing)

ブラウザパネル – 他のウェブコンテンツを埋め込むためにiframeを採用する予定。
Linuxデスクトップ統合 – エージェントがLinuxデスクトップを制御できるようにする。
ターミナルサポート – ブラウザ経由でインタラクティブシェルにアクセス。
Gitワーカー統合 – Git操作をより密接に統合。
一般のコミュニティ主導の改善。

Who’s it for?

すでに Codex Desktop を使っている開発者で、ポータブルでブラウザベースのUIを望む人。
中央の常時稼働マシン上でエージェントを実行したいチームで、ユーザーはどこからでもアクセスできるようにしたい人。
ネットワーク上に強力なローカルエージェントを公開するセキュリティの影響を理解できる人。

Alternatives mentioned

pocodex – 過去のプロジェクトで、サブエージェントやインライン画像のサポートがありません。
Codex Remote（組み込み機能フラグ） – SSH経由で動作しますが、クライアント側にデスクトップクライアントが必要なため、モバイル対応ではありません。
OpenAIの今後リリース予定のモバイルアプリ – まだリリースされていません。codex‑web が一時的な空白を埋めています。

How to contribute or get help

バグや機能要望はリポジトリのIssueで報告してください。
X（Twitter）で興味深いユースケースを共有し、@0xcaff をタグしてください。
商用または高度にカスタマイズされた展開の場合は、作者がメールでの直接連絡を歓迎しています。

TL;DR

codex‑web は、Codex Desktop AIエージェントプラットフォームをブラウザでアクセス可能なUIに変える最小限のNode.jsサーバーです。すべての実行は信頼できるホスト上で行われます。リモート、モバイル、マルチデバイスアクセスに便利ですが、サーバーは誰でもアクセスできるとホストを完全に制御できるため、セキュリティを確保する必要があります。