# Build Remote Agent — compatibility

Product: **Build Remote Agent** (store apps) + free MIT `gbr-agent`.
Website: https://grokbuildremote.com/integrations.html
Agent: https://github.com/LinespottingOrg/GrokBuildRemote-Agents
Protocol: `gbr/1` · agent **v0.6.0+**
Independent Linespotting AB product. Not affiliated with xAI or SpaceX.

## What the phone sees

`gbr-agent` discovers **terminal windows** on the paired PC. One pair = one mailbox for the **whole machine** (every discovered TTY, soft max 255). Headless OpenCode / CodeNomad sidecar / Electron UIs do **not** appear. `:8788` in a sidecar is Bot API JSON, not a transcript.

https://github.com/LinespottingOrg/GrokBuildRemote-Agents/blob/main/docs/WHAT-THE-PHONE-SEES.md

## Pair (one protocol)

```
gbr-agent pair    # QR in browser AND printed 8-char code
gbr-agent run     # keep running
```

Phone: Build Remote Agent → Scan QR (or type the code).
Unpair in Settings before a new mailbox. Force-close is not enough.
No fourth pair protocol.

Install: checksum **the installer** from GitHub Release v0.6.0, then the binary (docs/PINNED-INSTALL.md / https://grokbuildremote.com/PINNED-INSTALL.md). Live website curl|bash is mutable — not for other official docs.

## Attach (only these)

| How | Where |
|-----|--------|
| Bot API | `http://127.0.0.1:8788` after `gbr-agent run` |
| MCP | `gbr-mcp` stdio (`mcp/gbr-mcp`) |

The paired app can list every discovered TTY and inject into them (host-keyboard authority). Device class `phone` is not an inject target. Never put `mailbox_key` in git or issues.

**Trust:** loopback `:8788` is **unauthenticated by default**. Set `GBR_BOT_REQUIRE_KEY=1` to require the mailbox key even on 127.0.0.1. Relay **pair** (`POST /v1/mb/:id/pair`) is keyless and throttled; push / poll / ack / Bot API require `X-GBR-Key`. `POST /v1/inject` types into listed TTYs. FAQ: https://grokbuildremote.com/integrations.html#faq · GitHub: https://grokbuildremote.com/integrations.html#github

## Compatible hosts

| Class | Examples | How to attach |
|-------|----------|----------------|
| Grok Build | Grok Build TUI, Grok Bot 2026-08-11 | inject into the live window; Bot API device classes |
| Grok remotes (companions) | Amnibro `:2421`, Farina `:7910`, ChrisP `:8787`, Kojo | GBR probes loopback; LAN/Tailscale UI stays |
| Claude Code / Cowork | `gbr-mcp`, `skills/openclaw/SKILL.md` | MCP stdio |
| Git-native CLIs | Aider and forks | MCP snippet + docs |
| Codex ecosystem | community plugins / MCP servers (not closed Codex core) | plugin or docs |
| Terminal TUIs | OpenCode, Crush, Gemini CLI, Qwen Code | MCP config |
| Local LLM CLIs | Open Interpreter, Local CLI, oh-my-pi, pi, VTCode | **TTY in a native terminal** after pair. Electron / `--remote` / WebUI ≠ roster. https://grokbuildremote.com/use-cases/local-cli.html |
| IDE agents | Cline, Goose, Zed extensions | MCP / docs |
| Autonomous SWE | OpenHands, SWE-agent | docs / skill |
| Mobile GUI agents | mobilerun, agent-device | **different job** (they drive a phone). GBR pairs the *desktop* coding agent |

## Plugin registry

https://github.com/LinespottingOrg/GrokBuildRemote-Agents/tree/main/plugins — Grok/Claude manifests, OpenCode `mcp.servers`, AiderDesk extension. Users install; we do not land vendor pages in other `examples/` trees.

## See also

- https://grokbuildremote.com/integrations.html — canonical index (FAQ + GitHub + unaffiliated links)
- https://grokbuildremote.com/use-cases/opencode.html — OpenCode TUI in a native terminal (not headless serve)
- https://grokbuildremote.com/use-cases/aider.html — Aider CLI in a terminal (on the phone); AiderDesk user extension ~/.aider-desk/extensions/gbr-pair (not core)
- https://grokbuildremote.com/use-cases/codenomad.html — CodeNomad + Grok Build CLI (TTY, not a SideCar)
- https://grokbuildremote.com/use-cases/grok-remotes.html — Amnibro :2421 / Farina :7910 / ChrisP :8787 stay LAN companions; GBR is store + HTTPS relay; GET /health probes
- https://grokbuildremote.com/use-cases/mobile-robots.html — mobilerun / agent-device drive a phone; GBR spectates a desktop TTY
- https://grokbuildremote.com/use-cases/claw.html — OpenClaw / Hermes / NemoClaw (unaffiliated; TTY, not sandbox / not OpenClaw mobile nodes)
- https://grokbuildremote.com/use-cases/local-cli.html — Open Interpreter / Local CLI (TTY after pair; headless HTTP UIs are not)
- https://grokbuildremote.com/use-cases/qa.html — go-to Grok multi-agent QA (free agent + relay; premium app spectator)
- https://grokbuildremote.com/llms.txt
- https://github.com/LinespottingOrg/GrokBuildRemote-Agents
- AGENTS.md in this repo (AIs)
- docs/BOT-API.md · SECURITY.md