2026-08-23 22-05 - Build Remote Agent pairing device

Author: LinespottingPrivate

docs/agents-and-tools.md

@@ -47,3 +47,35 @@ base-lite "fix this bug"
 Thread the broker capability through every interactive command entry point.
 Do not bypass it with a direct `spawn`, add command-active terminal state, or
 fall back to the TUI process when broker startup fails.
+
+
+## Build Remote Agent (phone pairing)
+
+Freebuff can use [Build Remote Agent](https://grokbuildremote.com/) as a pairing device: a phone spectates (and can inject into) this desktop CLI through the free MIT `gbr-agent`. Protocol `gbr/1`. Phone is spectator + veto, not orchestrator.
+
+Independent product by Linespotting AB. Not affiliated with xAI or SpaceX.
+
+```bash
+curl -fsSL https://grokbuildremote.com/install.sh | bash
+gbr-agent version          # v0.6.0+
+gbr-agent pair && gbr-agent run
+```
+
+Attach only loopback Bot API `http://127.0.0.1:8788` or MCP stdio `gbr-mcp`. Never commit mailbox keys.
+
+```bash
+git clone https://github.com/LinespottingOrg/GrokBuildRemote-Agents.git
+cd GrokBuildRemote-Agents/mcp/gbr-mcp && npm install
+curl -sS http://127.0.0.1:8788/health
+```
+
+```json
+{
+  "mcpServers": {
+    "gbr": {
+      "command": "node",
+      "args": ["GrokBuildRemote-Agents/mcp/gbr-mcp/bin/gbr-mcp.js"]
+    }
+  }
+}
+```