Mac を準備する
CodexPocket の実行側は Mac です。iPhone は操作画面なので、Mac で Codex が普段どおり動き、CodexPocketMac が待ち受けできれば使い始められます。

CodexPocketMac の入手方法
Mac アプリをダウンロード リリースノートを見る ソースから起動する※ GitHub Releases から .dmg をダウンロードして、Mac にインストールしてください。
現在公開中の Mac stable は 0.1.3 です。通常は notarized DMG をダウンロードすればそのまま始められます。開発版や検証版を試したいときだけ、mac-app README の Quickstart から source build を使ってください。
先に結論
普段 Mac で Codex を使っている人なら、新しくやることは多くありません。
CodexPocketMacを起動するcodexが使えることを確認する- 使いたい workspace が Codex App に入っているか確認する
- Bridge が動いていることを確認する
- Pairing QR を iPhone で読み取る
Git はブランチ関連を使う人だけ必要です。ポートやトークン、Project の手動追加は通常触らなくて構いません。
やりたいことから探す
| やりたいこと | 読むページ |
|---|---|
| 最初にどこだけ見ればよいか知りたい | 最初にやること |
| Codex App を使う前提で進めたい | Codex App をインストールする |
codex CLI の状態を確認したい | Codex CLI をインストールする |
| ブランチ切り替えのために Git も整えたい | Git を使えるようにする |
| Project を手で追加したい | Project を追加する |
| 最後に Bridge の起動まで確認したい | Bridge を開始する |
Mac 側で担っていること
- Bridge の起動と停止
- iPhone に見せる Project 一覧の管理
codexを使った Thread と Exec の実行- Pairing QR の表示
- 状態確認とログ管理
どこを見ればよいか
一般Bridge のオンとオフ、ログイン時起動、全体の状態を見る場所です。プロジェクトCodex App から入ってきた workspace や、iPhone に見える Project 一覧を確認する場所です。ペアリングQR、Pairing URL、Pairing Code を出す場所です。詳細codex、git、シェルの検出状態を確認する場所です。ログBridge がうまく動かないときに stdout と stderr を見る場所です。
このセクションの読み方
- 最初に見るのは 最初にやること
- Codex App を使っているなら Codex App をインストールする と Project を作成する
codexの確認は Codex CLI をインストールする- ブランチ操作も使うなら Git を使えるようにする
- Project を手で追加したいときだけ Project を追加する
- 最後に Bridge を開始する