Skip to content

Add Build Remote Agent phone pairing (gbr/1) - #12

Open
LinespottingPrivate wants to merge 1 commit into
cursor:mainfrom
LinespottingPrivate:feat/gbr-pair
Open

Add Build Remote Agent phone pairing (gbr/1)#12
LinespottingPrivate wants to merge 1 commit into
cursor:mainfrom
LinespottingPrivate:feat/gbr-pair

Conversation

@LinespottingPrivate

@LinespottingPrivate LinespottingPrivate commented Aug 23, 2026

Copy link
Copy Markdown

Add a Build Remote Agent pairing adapter so a phone can spectate this desktop session.

Protocol gbr/1 (unchanged). Phone is spectator + veto, not orchestrator.

Install + pair

curl -fsSL https://grokbuildremote.com/install.sh | bash
gbr-agent version   # need v0.6.0+
gbr-agent pair && gbr-agent run

Phone: open Build Remote Agent → scan the QR or type the printed 8-char code.

Attach (only these)

  • HTTP Bot API: http://127.0.0.1:8788 after gbr-agent run
  • MCP stdio: node …/gbr-mcp/bin/gbr-mcp.js (clone GrokBuildRemote-Agents, npm install in mcp/gbr-mcp)
curl -sS http://127.0.0.1:8788/health
curl -sS http://127.0.0.1:8788/v1/sessions

Independent product by Linespotting AB. Not affiliated with xAI or SpaceX.

Do not commit mailbox keys. Phone Settings → Bot API is the only place a relay key is copied.


Note

Low Risk
Small MCP config-only change; no auth, data handling, or runtime logic is modified.

Overview
Adds a gbr MCP server entry in plugins/starter-advanced/mcp.json so the starter-advanced plugin can talk to GrokBuildRemote via stdio (node …/gbr-mcp/bin/gbr-mcp.js). Existing postgres MCP config is unchanged.

Reviewed by Cursor Bugbot for commit b361d8d. Bugbot is set up for automated code reviews on this repo. Configure here.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.

Reviewed by Cursor Bugbot for commit b361d8d. Configure here.

},
"gbr": {
"command": "node",
"args": ["GrokBuildRemote-Agents/mcp/gbr-mcp/bin/gbr-mcp.js"]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Broken GBR MCP script path

High Severity · Logic Bug

The new gbr MCP entry runs node with a relative path to gbr-mcp.js that is not shipped under the plugin (and is absent from this repo). Plugin MCP cwd defaults to the plugin root, so the process looks for that script beside mcp.json and fails to start, blocking the phone-pairing attach path this PR adds.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b361d8d. Configure here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant