#iOSアプリ

cmux iOSアプリはMacのコンパニオンです。cmuxを実行しているMacとiPhoneまたはiPadをペアリングし、スマートフォンからターミナルにアタッチできます。ターミナル通知の転送もオプションで利用できます。

iOSアプリはベータ版です。TestFlightで「cmux BETA」として提供されています。

#入手方法

アプリはTestFlightで配布されています。早期アクセスはcmux Founders Editionに含まれ、他の早期機能も利用できます。

#前提条件

始める前に、次のものが必要です：

cmuxを実行し、サインイン済みのMac。
TestFlightからcmux BETAアプリをインストールしたiPhoneまたはiPad。
スマートフォンからMacへのネットワーク経路（下記の「持ち込みネットワーク」を参照）。

#持ち込みネットワーク

cmuxはネットワーク機能を標準では提供しません。ターミナルのストリームはスマートフォンとMacの間を直接流れるため、スマートフォンがネットワーク上でMacに到達できる必要があります。最も簡単なのはプライベートなオーバーレイネットワークです。

#Tailscale（推奨）

Macとスマートフォンの両方にTailscaleをインストールし、同じtailnetにサインインします。これでスマートフォンはどこからでも、ポート転送なしでMacのtailnetアドレスに到達できます。

#WireGuard

すでにWireGuardを運用している場合は、Macとスマートフォンを同じネットワークに置き、MacのWireGuardアドレスを使用します。

どちらを選んでも、接続はあなた自身のものです。cmuxはデバイス間のターミナルトラフィックをプロキシしたり中継したりしません。

#ペアリングと接続

Macで、cmuxのMobile Connectウィンドウを開きます。
スマートフォンでcmux BETAアプリを開き、Mobile Connectに表示されるペアリングを確認します。
ペアリングが完了すると、ワークスペースとターミナルがネットワーク経由でスマートフォンに表示されます。

ペアリングはデバイスごとです。新しいデバイスやアプリの再インストール時は再度ペアリングします。

#通知

ターミナル通知をスマートフォンに転送するようにオプトインできます。注意が必要なペインがデバイスにプッシュされます。転送が有効な場合、通知のテキスト（ターミナル出力から取得したタイトルと本文）は、配信のためcmuxサーバーを経由してAppleのプッシュサービスに送信されます。通知設定で「コンテンツを隠す」を有効にすると、代わりに汎用的なメッセージが送信され、ターミナルのテキストはデバイスにとどまります。cmuxがどのように通知を発生させるかは通知をご覧ください。

#保存されるデータ

cmuxは、ターミナルがあなたのデバイス間にとどまるように設計されています。cmuxサーバーには、サインインとデバイス接続に必要なものだけを保存します：

サインインで取得するアカウント（メールアドレス）。デバイス間であなたを識別するため。
デバイスのプッシュトークン。転送されたターミナル通知を配信するため。
ペアリングとデバイスのメタデータ。スマートフォンとMacを接続するため。

インタラクティブなターミナルセッション（その内容とキー入力）は、あなた自身のネットワークを通じてスマートフォンとMacの間を直接流れ、cmuxサーバーを経由したり保存されたりすることはありません。唯一の例外は転送される通知テキストで、これはスマートフォンに届くためにcmuxとAppleのプッシュサービスを経由します（「コンテンツを隠す」を有効にしている場合を除く。上記の「通知」を参照）。

#エンタープライズとセルフホスト

セルフホストまたはエアギャップ環境での導入については、founders@manaflow.comまでご連絡ください。