iOSアプリ
cmux iOSアプリはMacのコンパニオンです。cmuxを実行しているMacとiPhoneまたはiPadをペアリングし、スマートフォンからターミナルにアタッチできます。ターミナル通知の転送もオプションで利用できます。
入手方法
アプリはTestFlightで配布されています。早期アクセスはcmux Founder's Editionに含まれ、他の早期機能も利用できます。
iPhone・iPad で cmux を設定する
iOS 版 cmux は Mac で動作する cmux に接続します。シェルとエージェントは Mac で実行を続け、スマートフォンやタブレットからワークスペースを表示・操作できます。
始める前に
- Mac に最新版の cmux をインストールし、ワークスペースを 1 つ以上開いた状態で起動しておきます。iOS 側で新しい Mac 版が必要と表示されたら、接続先の cmux アプリを更新してください。
- iPhone または iPad に cmux をインストールします。ベータ版の場合は TestFlight の招待を受け入れ、TestFlight から cmux BETA をインストールします。
- 両方の端末をインターネットに接続し、同じ cmux アカウントを使います。チームを利用している場合は、両方で同じチームを選択します。
Mac 版 cmux をダウンロード · iOS 版 cmux を入手
1. Mac でペアリングを有効にする
- Mac で cmux を開き、cmux アカウントにログインします。
- cmux の設定で「モバイル」を選び、「iOS ペアリングを有効にする」をオンにします。スマートフォンから使いたい Mac 上の各 cmux アプリで設定してください。
- cmux を起動したまま、Mac をスリープさせずに保ちます。Mac がスリープ、シャットダウン、または切断されると、スマートフォンからターミナルに接続できません。
2. iOS からログインして接続する
- iPhone または iPad で cmux を開き、Mac と同じ cmux アカウントでログインします。複数のアカウントを持っている場合は、両方のメールアドレスを確認してください。
- アプリの案内に従います。「通知を有効にする」を選ぶか、「後で」を選んで後から設定します。ペアリングのページで、Mac の iOS ペアリングを有効にしたことを確認します。
- 「自動接続」を選び、「自分の Mac を確認」をタップします。同じアカウントにログインしている対応 Mac が検出されます。自動接続に Tailscale のインストールは不要です。
- Mac が接続されたら「ワークスペースを開く」をタップします。ワークスペースとターミナルを選ぶと、出力の表示や入力ができます。上部の「すべてのコンピュータ」で接続先を切り替えられます。
任意: Tailscale のみで接続する
- Mac と iPhone・iPad に Tailscale をインストールし、同じ Tailscale ネットワークにログインします。両方で Tailscale が接続されていることを確認します。
- cmux の設定 > モバイルで iOS ペアリングを有効にしておきます。iOS の接続方法で「Tailscale のみ」を選び、「ペアリングコードをスキャン」を選択します。
- Mac の cmux で Mobile Connect を開き、スマートフォンでペアリングコードを読み取ります。求められたらカメラへのアクセスを許可し、画面の案内に従います。
- このモードでは、Wi-Fi からモバイル通信に切り替える場合も含め、両方の端末で Tailscale を接続したままにします。Tailscale のアクセスルールで、スマートフォンから Mac への接続を許可する必要があります。
3. エージェント通知を有効にする
- アプリの案内で「通知を有効にする」をタップし、iOS の確認画面で許可します。スキップまたは拒否した場合は、iOS の設定 > 通知 > cmux で「通知を許可」を有効にします。
- 両方の端末で cmux の通知設定を確認し、転送設定が表示される場合は有効にします。新しいエージェント通知を送信できるよう、Mac を起動・接続したままにします。
- 設定済みのコーディングエージェントがあるワークスペースで通知を発生させます。cmux の通知タブとスマートフォンへの配信を確認します。集中モードや通知の要約により、通知が遅延または消音される場合があります。
4. 接続を確認する
- スマートフォンからターミナルを開き、pwd などの安全なコマンドを実行します。スマートフォンと Mac の同じワークスペースに出力が表示されることを確認します。
- 別のワークスペースに切り替えてから戻ります。外出先で使う予定なら、Mac から離れる前にモバイル通信でも試してください。
- リモートアクセスには Mac を電源に接続し、スリープさせずに保ちます。設定中にスリープ防止の選択肢が表示された場合は、Mac を接続可能にしておくために利用できます。
ワークスペースが表示されない場合
設定を修正したらワークスペースに戻り、「再試行」をタップします。保存済みの Mac への再接続、またはワークスペース一覧とアカウントに保存された接続情報の更新を行います。
Mac が見つからない
接続したい Mac アプリの設定 > モバイルで iOS ペアリングが有効か確認します。両方で同じ cmux アカウントとチームを選び、Mac アプリを起動したままにしてください。「コンピュータ」ボタンで利用可能な Mac を確認し、非表示にしていないか調べます。
新しい Mac アプリを求められる
Mac の cmux を更新し、そのアプリを終了して開き直します。複数の cmux バージョンを使っている場合は、更新したものをスマートフォンで選択してください。iOS アプリに表示された最低バージョンに従います。
Mac は表示されるが接続できない
Mac をスリープから復帰させ、両方のインターネット接続を確認します。求められた場合は iOS のローカルネットワークアクセスを許可します。「Tailscale のみ」では、両方が同じネットワークに接続し、アクセスルールが通信を許可していることを確認してから再試行します。
接続できるのに一覧が空
Mac の cmux でワークスペースを作成するか開きます。スマートフォンで「すべてのコンピュータ」を選び、検索やフィルターを解除します。一覧を下に引いて更新するか、空の画面で「再試行」をタップします。
解決しない場合
Mac と iOS の cmux バージョン、接続方法、正確なエラー、コンピュータ一覧に Mac が表示されるかをお知らせください。パスワードやペアリングコードは含めないでください。
前提条件
始める前に、次のものが必要です：
- cmuxを実行し、サインイン済みのMac。
- TestFlightからcmux BETAアプリをインストールしたiPhoneまたはiPad。
- スマートフォンからMacへのネットワーク経路（下記の「持ち込みネットワーク」を参照）。
持ち込みネットワーク
cmuxはネットワーク機能を標準では提供しません。ターミナルのストリームはスマートフォンとMacの間を直接流れるため、スマートフォンがネットワーク上でMacに到達できる必要があります。最も簡単なのはプライベートなオーバーレイネットワークです。
Tailscale（推奨）
Macとスマートフォンの両方にTailscaleをインストールし、同じtailnetにサインインします。これでスマートフォンはどこからでも、ポート転送なしでMacのtailnetアドレスに到達できます。
WireGuard
すでにWireGuardを運用している場合は、Macとスマートフォンを同じネットワークに置き、MacのWireGuardアドレスを使用します。
ペアリングと接続
- Macで、cmuxのMobile Connectウィンドウを開きます。
- スマートフォンでcmux BETAアプリを開き、Mobile Connectに表示されるペアリングを確認します。
- ペアリングが完了すると、ワークスペースとターミナルがネットワーク経由でスマートフォンに表示されます。
ペアリングはデバイスごとです。新しいデバイスやアプリの再インストール時は再度ペアリングします。
通知
ターミナル通知をスマートフォンに転送するようにオプトインできます。注意が必要なペインがデバイスにプッシュされます。転送が有効な場合、通知のテキスト（ターミナル出力から取得したタイトルと本文）は、配信のためcmuxサーバーを経由してAppleのプッシュサービスに送信されます。通知設定で「コンテンツを隠す」を有効にすると、代わりに汎用的なメッセージが送信され、ターミナルのテキストはデバイスにとどまります。cmuxがどのように通知を発生させるかは通知をご覧ください。
保存されるデータ
cmuxは、ターミナルがあなたのデバイス間にとどまるように設計されています。cmuxサーバーには、サインインとデバイス接続に必要なものだけを保存します：
- サインインで取得するアカウント（メールアドレス）。デバイス間であなたを識別するため。
- デバイスのプッシュトークン。転送されたターミナル通知を配信するため。
- ペアリングとデバイスのメタデータ。スマートフォンとMacを接続するため。
エンタープライズとセルフホスト
セルフホストまたはエアギャップ環境での導入については、founders@cmux.comまでご連絡ください。