HN 日本語サマリー

← 一覧へ戻る
プログラミング

Grok-iOS – iPhoneからACP経由でGrokビルドをリモート実行

Grok-iOS – remote Grok Build from your iPhone over ACP (github.com)

10 pointsby pedroshakoor0 コメント

要約

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

[画像: Welcome screen]

要件

  • 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.12419
物理iPhone(同一Wi-Fi)あなたのMacのLAN IP2419

アーキテクチャ

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 を参照してください。