プログラミング
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 Build 用のiOSクライアント。
電話はページャーUIとして機能します。Macは grok agent serve を介して公式エージェントを実行します。これらはWebSocket上でACPを介して通信します。
著者: Pedro Shakour
ライセンス: Apache-2.0
要件
- Grok CLI (
grok) を搭載したmacOS - 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-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上に留まり、電話はリモートページャーとして機能します。
- テーマとスラッシュ名はアップストリームのGrok Buildから取得されます。
ライセンス
Apache-2.0。LICENSE、NOTICE、THIRD-PARTY-NOTICES を参照してください。