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

> Source: <https://github.com/Pedroshakoor/grok-build-ios>
> Published: 2026-07-19 21:51:26+00:00

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`

.