Grok-iOS is an open-source iOS client for Grok Build, letting you trigger remote builds from your iPhone over ACP via WebSocket. Created by Pedro Shakour under the Apache-2.0 license, the app acts as a pager UI while the official `grok agent serve` runs on a Mac.

Requirements include macOS with Grok CLI, an xAI API key, Xcode 16+, and iOS 17+. Clone the repo with submodules: `git clone --recurse-submodules https://github.com/Pedroshakoor/grok-build-ios.git`.

Quick start: 1) On Mac, export `XAI_API_KEY`, kill any process on port 2419, then run `grok agent serve` to get a Secret. 2) Open `ios/Grok App/Grok App.xcodeproj` in Xcode and run on Simulator or device. 3) In the app, paste the Secret, connect, and create a new worktree. Simulator uses `127.0.0.1:2419`; a physical iPhone on the same Wi‑Fi uses the Mac’s LAN IP.

Architecture: SwiftUI app → ACP/JSON‑RPC over WebSocket → `grok agent serve` (Mac). The repo includes the iOS app, a legacy TLS/Bonjour bridge, pinned upstream submodules, and demo scripts. Not on the App Store — sideload or use Simulator only.