{"slug": "grok-ios-remote-grok-build-from-your-iphone-over-acp", "title": "Grok-iOS – remote Grok Build from your iPhone over ACP", "summary": "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.", "body_md": "iOS client for [Grok Build](https://github.com/xai-org/grok-build).\n\nThe phone is the pager UI. Your Mac runs the official agent via `grok agent serve`\n\n. They talk ACP over WebSocket.\n\n**Author:** Pedro Shakour\n\n**License:** Apache-2.0\n\n- macOS with\n[Grok CLI](https://x.ai/cli)(`grok`\n\n) - xAI API key\n- Xcode 16+ (Simulator or device)\n- iOS 17+\n\n```\ngit clone --recurse-submodules https://github.com/Pedroshakoor/grok-build-ios.git\ncd grok-build-ios\n```\n\nIf you already cloned without submodules:\n\n```\ngit submodule update --init --recursive\nexport XAI_API_KEY=xai-...\nlsof -ti tcp:2419 | xargs kill -9 2>/dev/null\ngrok agent serve\n```\n\nThe CLI prints a **Secret**. Leave this terminal open.\n\nOpen `ios/GrokApp/GrokApp.xcodeproj`\n\nin Xcode → run on Simulator or device.\n\nOr:\n\n```\n./scripts/run-simulator-demo.sh\n```\n\nIn the app: **Setup** → paste the Secret → **connect** → **continue** → **New worktree**.\n\n| Client | Host | Port |\n|---|---|---|\n| Simulator | `127.0.0.1` |\n`2419` |\n| Physical iPhone (same Wi‑Fi) | your Mac LAN IP | `2419` |\n\n```\niOS (SwiftUI)  ──ACP / JSON-RPC over WebSocket──►  grok agent serve (Mac)\n```\n\nOptional legacy LAN bridge (TLS + Bonjour) lives under `companion/`\n\nfor experiments. The default path is official `grok agent serve`\n\n.\n\n| Path | Purpose |\n|---|---|\n`ios/GrokApp/` |\nSwiftUI app |\n`companion/` |\nLegacy ACP TCP/TLS bridge |\n`shared/` |\nThemes + slash catalog from upstream |\n`upstream-grok-build/` |\nPinned\n|\n\n`scripts/`\n\n`docs/`\n\n```\nbash scripts/check-source-rev.sh\nbash scripts/smoketest.sh\n```\n\nStub ACP (CI / no API key):\n\n```\n./scripts/run-simulator-stub-demo.sh\n```\n\n- Not on the App Store — open-source / sideload / Simulator only.\n- Agent runtime stays on the Mac; the phone is a remote pager.\n- Themes and slash names are taken from upstream Grok Build.\n\nApache-2.0. See `LICENSE`\n\n, `NOTICE`\n\n, and `THIRD-PARTY-NOTICES`\n\n.", "url": "https://wpnews.pro/news/grok-ios-remote-grok-build-from-your-iphone-over-acp", "canonical_source": "https://github.com/Pedroshakoor/grok-build-ios", "published_at": "2026-07-19 21:51:26+00:00", "updated_at": "2026-07-20 13:46:36.272217+00:00", "lang": "en", "topics": ["ai-tools", "developer-tools", "artificial-intelligence"], "entities": ["Pedro Shakour", "Grok Build", "xAI", "Apple", "Xcode"], "alternates": {"html": "https://wpnews.pro/news/grok-ios-remote-grok-build-from-your-iphone-over-acp", "markdown": "https://wpnews.pro/news/grok-ios-remote-grok-build-from-your-iphone-over-acp.md", "text": "https://wpnews.pro/news/grok-ios-remote-grok-build-from-your-iphone-over-acp.txt", "jsonld": "https://wpnews.pro/news/grok-ios-remote-grok-build-from-your-iphone-over-acp.jsonld"}}