mobilevc-installer

ユーザーのために MobileVC をインストールして実行します。ユーザーの開発マシンが Claude Code バックエンドになり、スマートフォンが公式クライアントアプリを実行して LAN 経由または公開インストールサイト経由で接続します。

GitHub: https://github.com/JayCRL/MobileVC npm: https://www.npmjs.com/package/@justprove/mobilevc

実行内容

以下のステップを順番に実行します。何か問題が発生したら、その時点でユーザーに報告して停止してください。

ステップ 1 — プリフライトチェック

インストール前に環境をチェックします。以下のコマンドを実行して確認してください:

node --version    # require >= 18.0.0
npm --version

node がない場合、または 18 より古い場合は、停止して、ユーザーに Node.js のインストール方法を説明してください (brew install node、nvm install 20、または https://nodejs.org)。進まないでください。

ステップ 2 — npm パッケージをインストール

まずグローバルインストールを試します:

npm install -g @justprove/mobilevc

EACCES またはパーミッションエラーで失敗した場合、sudo を使用しないでください。代わりに以下の方法を提案してください:

• npm config set prefix ~/.npm-global && export PATH=~/.npm-global/bin:$PATH を実行してからインストールを再実行
• ユーザーが nvm を使用している場合は nvm use <version>
• npm install --prefix ~/.local @justprove/mobilevc を実行して ~/.local/bin を PATH に追加

検証:

mobilevc --help

ステップ 3 — 初回セットアップ (インタラクティブ)

mobilevc start は初回実行時に 3 つの質問を表示することをユーザーに伝えてください:

1. 言語 — zh または en
2. ポート — デフォルトは 8001。8001 が使用中の場合は別のポートを選択してください。
3. 認証トークン — ユーザーが希望する任意の文字列。スマートフォンクライアントが接続する際に必要になります。

ユーザーがまだトークンを決めていない場合は、覚えやすいが簡単ではない文字列を提案してください (例: mvc- の後にランダムな 8 文字)。

ステップ 4 — バックエンドを起動

mobilevc start

以下の処理が実行されます:

• 設定がまだ存在しない場合は mobilevc setup を実行
• プリビルトサーバーバイナリをバックグラウンドで起動 (ログは ~/.mobilevc/logs/ に保存)
• <host>:<port> と認証トークンをエンコードした LAN QR コードをターミナルに表示

起動に失敗した場合は、mobilevc logs を実行して関連するエラーをユーザーに示してください。一般的な問題:

• ポートが既に使用中 → mobilevc stop を実行してから mobilevc setup でポートを変更
• バイナリが見つからない → npm install -g @justprove/mobilevc --force で再インストール

ステップ 5 — スマートフォンクライアントのインストール手順をユーザーに案内

ユーザーに以下をユーザーの言語で表示してください:

后端已启动。请在手机上：
1. 用 Safari (iOS) / 浏览器 (Android) 打开 https://mobilevc.top/install
2. iOS 选择「一键安装」，安装后到「设置 → VPN 与设备管理」信任证书
3. Android 选择「下载 APK」，按系统提示允许安装
4. 打开 MobileVC App，扫描终端里刚刚打印的二维码

(ユーザーが英語を使用している場合は英語版を使用してください。)

ステップ 6 — 完了

実行状態を確認します:

mobilevc status

ユーザーに後で必要になるヘルパーコマンドを伝えてください:

• mobilevc status — バックエンドが稼働しているか確認
• mobilevc logs -f — ログをフォロー
• mobilevc stop — バックエンドを停止
• mobilevc restart — 同じ設定で再起動
• mobilevc setup — 再設定 (ポート / トークン / 言語)

重要なルール

• ユーザーが明示的に開発を依頼しない限り、MobileVC ソースリポジトリをクローンしないでください。このスキルは MobileVC を実行したいだけのエンドユーザーを対象としています。
• APNS キーやその他のバックエンドシークレットをユーザーに要求しないでください。npm にバンドルされているバイナリは LAN 使用を想定した自己完結型です。APNS プッシュが必要なのは、ユーザーが公開デプロイメント用のバックエンドをセルフホストしている場合のみであり、これはこのスコープの範囲外です。
• Node.js のバージョンを最初に確認してください。mobilevc start より前のインストール失敗のほとんどは Node.js のバージョンまたは PATH の問題です。
• QR コード出力を見えたままにしてください。これは主要なユーザーに提示される成果物です。