原文
iOS client for Grok Build.
The phone is the pager UI. Your Mac runs the official agent via grok agent serve. They talk ACP over WebSocket.
Author: Pedro Shakour
License: Apache-2.0
- macOS with Grok CLI (
grok) - xAI API key
- Xcode 16+ (Simulator or device)
- iOS 17+
git clone --recurse-submodules https://github.com/Pedroshakoor/grok-build-ios.git
cd grok-build-iosIf you already cloned without submodules:
git submodule update --init --recursiveexport XAI_API_KEY=xai-...
lsof -ti tcp:2419 | xargs kill -9 2>/dev/null
grok agent serveThe CLI prints a Secret. Leave this terminal open.
Open ios/GrokApp/GrokApp.xcodeproj in Xcode → run on Simulator or device.
Or:
./scripts/run-simulator-demo.shIn the app: Setup → paste the Secret → connect → continue → New worktree.
| Client | Host | Port |
|---|---|---|
| Simulator | 127.0.0.1 |
2419 |
| Physical iPhone (same Wi‑Fi) | your Mac LAN IP | 2419 |
iOS (SwiftUI) ──ACP / JSON-RPC over WebSocket──► grok agent serve (Mac)
Optional legacy LAN bridge (TLS + Bonjour) lives under companion/ for experiments. The default path is official grok agent serve.
| Path | Purpose |
|---|---|
ios/GrokApp/ |
SwiftUI app |
companion/ |
Legacy ACP TCP/TLS bridge |
shared/ |
Themes + slash catalog from upstream |
upstream-grok-build/ |
Pinned xai-org/grok-build submodule |
scripts/ |
Demo + smoke helpers |
docs/ |
Screenshots |
bash scripts/check-source-rev.sh
bash scripts/smoketest.shStub ACP (CI / no API key):
./scripts/run-simulator-stub-demo.sh- Not on the App Store — open-source / sideload / Simulator only.
- Agent runtime stays on the Mac; the phone is a remote pager.
- Themes and slash names are taken from upstream Grok Build.
Apache-2.0. See LICENSE, NOTICE, and THIRD-PARTY-NOTICES.