Grok-iOS – remote Grok Build from your iPhone over ACP

Pedro Shakour released Grok-iOS, an open-source iOS client that lets users remotely control Grok Build from an iPhone over ACP via WebSocket. The app acts as a pager UI while the agent runs on a Mac using the official Grok CLI, requiring Xcode 16+, iOS 17+, and an xAI API key. The project is licensed under Apache-2.0 and is available only through sideloading or the Simulator, not the App Store.

iOS client for Grok Build https://github.com/xai-org/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 https://x.ai/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-ios If you already cloned without submodules: git submodule update --init --recursive export XAI API KEY=xai-... lsof -ti tcp:2419 | xargs kill -9 2 /dev/null grok agent serve The 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.sh In 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 | scripts/ docs/ bash scripts/check-source-rev.sh bash scripts/smoketest.sh Stub 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 .