grok-ios
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
Requirements
macOS with Grok CLI (grok)
xAI API key
Xcode 16+ (Simulator or device)
iOS 17+
Clone
If you already cloned without submodules:
Quick start
1. Start the agent on your Mac
The CLI prints a Secret. Leave this terminal open.
2. Run the iOS app
Open ios/GrokApp/GrokApp.xcodeproj in Xcode → run on Simulator or device.
Or:
3. Connect
In the app: Setup → paste the Secret → connect → continue → New worktree.
Architecture
Optional legacy LAN bridge (TLS + Bonjour) lives under companion/ for experiments. The default path is official grok agent serve.
Repo layout
Development
Stub ACP (CI / no API key):
Notes
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.
License
Apache-2.0. See LICENSE, NOTICE, and THIRD-PARTY-NOTICES.