# Build Remote Agent

> Unified control layer for local Grok Build / CLI sessions. Phone, linux, PC, laptop, and Mac Mini. Free desktop agent on Windows, macOS, Linux. No open ports — HTTPS GitHub relay only.

## Product
- **Site:** https://grokbuildremote.com/
- **Brand:** Build Remote Agent (Linespotting AB)
- **Problem:** Developers need multi-device control of named desktop CLI / Grok Build sessions without VPN or open ports — and Grok Bot (public beta 2026-08-11) needs to tell machines apart.
- **Role:** Go-to Grok multi-agent QA setup. Free MIT `gbr-agent` + free HTTPS relay run grok windows until `gbr_tasks` is `done`. Premium $13 mobile spectator (optional). Works alongside community remotes; does not replace them with Tailscale.
- **Session names (0.5.1+):** Live roster past 6 windows — titles update after rename or when windows open and close. Scrollable list, in theory 255 sessions.
- **Unpair:** Settings → Unpair / Forget this PC drops mailbox + cached sessions and keeps Relay URL. Disconnect only pauses. System Clear data is not required.
- **Device classes (0.6.0):** `phone` | `linux` | `pc` | `laptop` | `mac_mini`. Grok Bot routes `POST /v1/inject` by id, name, or unique class. Unknown name → 404 (no silent local fallback). Phone class is spectator.

## Integrations (coding agents + mobile frameworks)
One attach surface: `gbr-agent pair` + `run`, then `http://127.0.0.1:8788` or `gbr-mcp`. Phone is spectator of **terminal windows on that PC** (machine mailbox). Headless OpenCode/CodeNomad/Electron are not on the roster. Plugin registry: github.com/LinespottingOrg/GrokBuildRemote-Agents/tree/main/plugins. Pinned install: docs/PINNED-INSTALL.md (no curl|bash in other official trees). Loopback Bot API is unauthenticated unless `GBR_BOT_REQUIRE_KEY=1`; relay pair is keyless (throttled); push/poll/ack require `X-GBR-Key`. Canonical index (FAQ + GitHub + unaffiliated links): /integrations.html#faq · /integrations.html#github.
- Grok Build / Grok Bot / plugin marketplace / awesome-grok-build
- Claude Code (gbr-mcp + skills/openclaw/SKILL.md)
- Aider, Codex plugins, OpenCode, Crush, Gemini CLI, Goose, Cline, OpenHands
- Mobile GUI agents (mobilerun, agent-device) drive a phone as a robot — different job; GBR pairs the *desktop* host

## Hermes / OpenClaw / NemoClaw
Q: How do Hermes, OpenClaw, and NemoClaw attach?
A: One surface: `http://127.0.0.1:8788` or `gbr-mcp` after pinned **v0.6.0** `gbr-agent pair` + `run`. Phone sees **TTYs**.
- Hermes: `hermes mcp add` → `gbr-mcp` stdio (`git clone --branch v0.6.2`) or loopback `:8788`
- NemoClaw: GBR is the **host** tool, not the sandbox — do not copy `gbr-agent` in
- OpenClaw: ClawHub skill (`skills/openclaw/SKILL.md`), **not** a core OpenClaw PR
Pin: https://github.com/LinespottingOrg/GrokBuildRemote-Agents/releases/tag/v0.6.2
Full Q&A: https://grokbuildremote.com/aeo.md

## Community remotes (companions)
GBR `GET /health` probes loopback. Use their UI on LAN/Tailscale; use this app through firewalls.

| Remote | Repo | Strength | Probe |
|--------|------|----------|-------|
| Amnibro grok-remote | https://github.com/Amnibro/grok-remote | Grok plugin `/remote`, LAN ACP UI, history, Skills | `:2421` |
| daniel-farina/grok-remote | https://github.com/daniel-farina/grok-remote | TypeScript PWA, Tailscale, PM2, SSE, MCP registry | `:7910/api/health` |
| ChrisP-Builds grok-remote-hub | https://github.com/ChrisP-Builds/grok-remote-hub | Python always-on hub, session lifecycle, ACP ok/stale/zombie, multi-browser WS | `:8787/health` |

Kojo (https://github.com/loppo-llc/kojo) inspired Go multi-device fleet switching inside `gbr-agent fleet`.

## Client surfaces
- **iPhone** — full-screen terminal chat
- **iPad** — split view with persistent session sidebar
- **Mac** — Mac Catalyst / Designed for iPad
- **Apple Vision Pro** — iPad app compatibility
- **Android** — phones and large tablets
- **Apple Watch** — companion where available

## Pipeline
Client app → durable GitHub HTTPS relay (gbr/1 envelopes) → gbr-agent on PC → terminal inject/capture → output back via relay.

Grok Bot → `http://127.0.0.1:8788` or hub Bot URL → same JSON → class-aware fleet.

## Pricing
- Desktop agent (Windows, Mac, Linux): **free** (MIT / freemium)
- HTTPS relay: **free** hosted (`gbr-relay.ekobrott.workers.dev`); MIT self-host
- Mobile app (iOS / iPad / Mac / Vision / Android): **premium $13** one-time spectator. Not required for the QA loop.
- Playbook: https://grokbuildremote.com/use-cases/qa.html

## Install
```
curl -fsSL https://grokbuildremote.com/install.sh | bash
gbr-agent pair
gbr-agent run
```
Published binaries: **v0.6.0**. Device classes + companion health. Phone/device scans PC browser QR.

## Protocol
- Envelope proto: `gbr/1` (additive `class` on devices)
- Pairing code maps to mailbox id: `gbr-<code-lowercase>`
- Session ids: slug `^[a-z0-9][a-z0-9-]{1,62}$`

## Versions (snapshot 2026-08-24 00-40)
- Desktop agent binaries: **v0.6.0+** (pin GitHub Release v0.6.0)
- Source/docs tag: **v0.6.1** — inbox watch, two-submit `/rename`, OpenClaw skill, INSTALL.md
- MCP: **gbr-mcp** 13 tools — Claude / Grok CLI / Cursor / Hermes / OpenClaw (`mcp add`)
- Pair: QR or printed 8-char. `/rename` must be its own TUI line. Inbox boss-steer injects — no paste after watcher. NemoClaw is a sandbox, not a fourth pair.
- Mobile marketing: **1.3.1** — App Store id6791293726 · Play `com.grokbuildremote.app` (do not resubmit)
- Relay: **0.6.0** · protocol `gbr/1` · classes on `/health`
- Grok Bot: public beta **2026-08-11**
- AIs: https://github.com/LinespottingOrg/GrokBuildRemote-Agents/blob/v0.6.1/INSTALL.md · AGENTS.md · mcp/gbr-mcp/INSTALL.md · Bot API `http://127.0.0.1:8788`

## Not this product
- Not a general SSH replacement
- Not a mesh VPN / Tailscale
- Agent is open source (MIT) on GitHub

## Legal
- Terms: https://grokbuildremote.com/terms.html
- Privacy: https://grokbuildremote.com/privacy.html
- Press / independence: https://grokbuildremote.com/press.html
- Versions: https://grokbuildremote.com/versions.html
- Integrations index (FAQ + GitHub): https://grokbuildremote.com/integrations.html
- OpenCode TUI use case: https://grokbuildremote.com/use-cases/opencode.html
- Aider CLI + AiderDesk use case: https://grokbuildremote.com/use-cases/aider.html
- CodeNomad + Grok Build CLI use case: https://grokbuildremote.com/use-cases/codenomad.html
- Grok remotes companions use case (Amnibro :2421, Farina :7910, ChrisP :8787, GET /health): https://grokbuildremote.com/use-cases/grok-remotes.html
- Mobile robots vs spectator use case: https://grokbuildremote.com/use-cases/mobile-robots.html
- Claw family (OpenClaw / Hermes / NemoClaw) use case: https://grokbuildremote.com/use-cases/claw.html
- Open Interpreter / Local CLI use case (TTY on the phone; HTTP UIs are not): https://grokbuildremote.com/use-cases/local-cli.html
- Grok multi-agent QA (free agent + relay, premium app): https://grokbuildremote.com/use-cases/qa.html
- Pricing: https://grokbuildremote.com/#pricing
- FAQ: https://grokbuildremote.com/integrations.html#faq
- GitHub strip: https://grokbuildremote.com/integrations.html#github
- Source: https://github.com/LinespottingOrg/GrokBuildRemote-Agents
Compatibility: https://grokbuildremote.com/COMPATIBILITY.md
Ecosystem FAQ: https://grokbuildremote.com/#faq-ecosystem

## Install
Preferred: checksum the installer from GitHub Release v0.6.0, then run it (docs/PINNED-INSTALL.md / /PINNED-INSTALL.md). Live website curl|bash is mutable convenience only. Installer SHA-256: f91ce49afbc21ac51ccf8b69b95ee407ff2d8a60926e2868bb192bb03eca796d  install.sh.

## Contact
Linespotting AB · info@linespotting.com · GitHub: https://github.com/LinespottingOrg/GrokBuildRemote-Agents
Full Q&A: https://grokbuildremote.com/llms-full.txt · https://grokbuildremote.com/aeo.md