Mac CLI Companion
review-server を動かし、iPhone アプリとペアを組む無料の Mac CLI です。
概要
Mac CLI companion は、SpecDock の無料の半分です。Mac 上で review-server
として動き、プロジェクトの Markdown と MDX を見張ります。iPhone
が同期や Agent Handoff のために実際に話しかける相手は、このプロセスです。
配布形式は npm パッケージなので、ダウンロードや解凍、ビルドは不要です。npx
からそのまま実行し、npx は常に指定したバージョンを取ってきます。
companion が動いていない間、iPhone アプリ側はサンプルデータしか見られません。
始め方
インストール
Mac のターミナルで下記を実行します。review-server
が起動し、iPhone から届く URL とペアリング用の QR コードが表示されます。
ペアリング
iPhone で SpecDock を開きます。同じ Wi-Fi 上にあれば、Bonjour で Mac を自動的に見つけ、一覧から選べます。CLI が表示した QR コードを読み込むか、6 桁のペアリングコードを手入力する方法もあります。
プロジェクトの追加
プロジェクトのフォルダ内で下記を実行すると、その場で登録されます。後からアプリ側で検出済み一覧から選ぶか、Add by Path でパスを直接入力して追加することもできます。
前提
無料
Mac CLI companion に費用はかかりません。iPhone アプリ側も、1 プロジェクトの読解とコメントまでは無料です。
Mac が必要
実際の同期と Agent Handoff を動かしているのは、この companion です。動いていない間、iPhone アプリはサンプルデータを見るだけになります。
Tailscale は任意
Tailscale は Wi-Fi の外から Mac に届く経路の 1 つで、必須ではありません。LAN、Bonjour、手入力の URL だけでも動き、どの経路でもペアリングは必要です。
配布物の完全性
companion は npm
で配布されているため、パッケージの完全性は npm 自体が担保します。手で照合するチェックサムはありません。specdock doctor や specdock version で、今動いているものを確認できます。