プログラミング
Grok-iOS – iPhoneからACP経由でGrokビルドをリモート実行
Grok-iOS – remote Grok Build from your iPhone over ACP (github.com)
要約
Grok-iOSは、iPhoneからGrokビルドをリモート操作するためのiOSクライアントです。Mac上で公式エージェントを実行し、WebSocket経由でACPプロトコルを使用して通信します。これにより、iPhoneがリモートのページャーUIとして機能します。
全文翻訳
Grok-iOSはGrokビルドのためのiOSクライアントです。電話がページャーUIとなります。Macはgrok agent serve経由で公式エージェントを実行します。これらはWebSocket上でACPを介して通信します。
著者: Pedro Shakour
ライセンス: Apache-2.0
要件
macOS (grok CLI搭載)
xAI APIキー
Xcode 16以降 (シミュレーターまたはデバイス)
iOS 17以降
クローン
git clone --recurse-submodules https://github.com/Pedroshakoor/grok-build-ios.git
cd grok-build-ios
サブモジュールなしで既にクローンした場合:
git submodule update --init --recursive
クイックスタート
1. Mac上でエージェントを開始する
export XAI_API_KEY=xai-...
lsof -ti tcp:2419 | xargs kill -9 2>/dev/null
grok agent serve
CLIはSecretを表示します。このターミナルを開いたままにしてください。
2. iOSアプリを実行する
Xcodeで ios/GrokApp/GrokApp.xcodeproj を開く → シミュレーターまたはデバイスで実行する。
または:
./scripts/run-simulator-demo.sh
3. 接続
アプリ内で: Setup → Secretを貼り付け → connect → continue → New worktree。
クライアント ホスト ポート
シミュレーター 127.0.0.1 2419
物理iPhone (同一Wi-Fi) あなたのMacのLAN IP 2419
アーキテクチャ
iOS (SwiftUI) ──ACP / JSON-RPC over WebSocket──► grok agent serve (Mac)
オプションのレガシーLANブリッジ (TLS + Bonjour) は、実験のために companion/ の下にあります。デフォルトのパスは公式のgrok agent serveです。
リポジトリレイアウト
パス 用途
ios/GrokApp/ SwiftUIアプリ
companion/ レガシーACP TCP/TLSブリッジ
shared/ upstreamからのテーマ+スlashカタログ
upstream-grok-build/ ピン留めされた xai-org/grok-build サブモジュール
scripts/ デモ+スモークヘルパー
docs/ スクリーンショット
開発
bash scripts/check-source-rev.sh
bash scripts/smoketest.sh
Stub ACP (CI / APIキーなし):
./scripts/run-simulator-stub-demo.sh
注記
App Storeにはありません — オープンソース / サイドロード / シミュレーターのみ。
エージェントランタイムはMac上に留まり、電話はリモートページャーです。
テーマとスlash名は、upstream Grok Buildから取得されます。
ライセンス Apache-2.0。LICENSE、NOTICE、およびTHIRD-PARTY-NOTICESを参照してください。