Skip to content

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

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

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

Conversation

@LinespottingPrivate

@LinespottingPrivate LinespottingPrivate commented Aug 23, 2026

Copy link
Copy Markdown

What

Add a short how-to so a phone running Build Remote Agent can pair to this desktop Grok Build session as a spectator.

Existing remotes stay. Telegram /remote-control stays.
Build Remote Agent is a separate pairing device: the iOS/Android store app plus free MIT gbr-agent over a GitHub/HTTPS relay (gbr/1). Phone and PC never open ports to each other. No fourth pair protocol.

gbr-agent already probes companion ports :2421 / :7910 / :8787 when those UIs are running (discovery only).

Pair + attach

curl -fsSL https://grokbuildremote.com/install.sh | bash   # Windows: irm https://grokbuildremote.com/install.ps1 | iex
gbr-agent version    # need v0.6.0+
gbr-agent pair && gbr-agent run
curl -sS http://127.0.0.1:8788/health
curl -sS http://127.0.0.1:8788/v1/sessions

MCP stdio: clone https://github.com/LinespottingOrg/GrokBuildRemote-Agents and run node mcp/gbr-mcp/bin/gbr-mcp.js.

Phone is spectator + veto. Orchestration stays on this desktop agent (or a bot talking to the same Bot API).

Notes

  • Independent product (Linespotting AB). Not affiliated with xAI or SpaceX.
  • Docs/skill only. No product-code change. No mailbox keys.
  • Host: superagent-ai/grok-cli

Website: https://grokbuildremote.com/
Agent: https://github.com/LinespottingOrg/GrokBuildRemote-Agents


Note

Low Risk
Documentation-only agent skill; no runtime, auth, or product-code changes.

Overview
Adds an agent skill at .agents/skills/gbr/SKILL.md so grok-cli can pair a phone running Build Remote Agent (gbr/1) as a spectator/inject device.

The skill documents install/pair (gbr-agent pair + run), loopback Bot API on 127.0.0.1:8788, MCP attach, and the diagnose→inject loop. Telegram /remote-control is left unchanged; no product code or mailbox keys are included.

Reviewed by Cursor Bugbot for commit 7804145. Configure here.

@open-cla

open-cla Bot commented Aug 23, 2026

Copy link
Copy Markdown

Contributor License Agreement

The following contributors need CLA coverage:

Review and sign the CLA

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