Skip to content

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

Open
LinespottingPrivate wants to merge 2 commits into
MoonshotAI:mainfrom
LinespottingPrivate:feat/gbr-pair
Open

Add Build Remote Agent phone pairing (gbr/1)#2616
LinespottingPrivate wants to merge 2 commits into
MoonshotAI:mainfrom
LinespottingPrivate:feat/gbr-pair

Conversation

@LinespottingPrivate

@LinespottingPrivate LinespottingPrivate commented Aug 23, 2026

Copy link
Copy Markdown

Add Build Remote Agent as a pairing device for this desktop agent.

The paid iOS/Android app spectates (and can inject into) the local session 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.

Pair (unchanged)

curl -fsSL https://grokbuildremote.com/install.sh | bash   # Windows: irm https://grokbuildremote.com/install.ps1 | iex
gbr-agent version          # v0.6.0+
gbr-agent pair             # QR in browser + printed 8-char code
gbr-agent run              # leave running

Phone: open Build Remote Agent → scan the QR or type the 8-char code. Unpair in Settings before changing PCs.

Attach (only these)

How Where
Bot API http://127.0.0.1:8788 after gbr-agent run
MCP stdio gbr-mcp (node mcp/gbr-mcp/bin/gbr-mcp.js)
curl -sS http://127.0.0.1:8788/health
curl -sS http://127.0.0.1:8788/v1/sessions

This PR is docs/example only. No mailbox keys, no X-GBR-Key, no device.json.


Open in Devin Review

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Devin Review found 1 potential issue.

View 1 additional finding in Devin Review. (Configure)

Open in Devin Review

Comment on lines +138 to +165
## Build Remote Agent (phone pairing)

Pair a phone running [Build Remote Agent](https://grokbuildremote.com/) to this Kimi Code CLI session. 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
git clone https://github.com/LinespottingOrg/GrokBuildRemote-Agents.git
cd GrokBuildRemote-Agents/mcp/gbr-mcp && npm install
```

Add the local stdio MCP server (loopback only). Never put mailbox keys in MCP config.

```sh
kimi mcp add --transport stdio gbr -- node /path/to/GrokBuildRemote-Agents/mcp/gbr-mcp/bin/gbr-mcp.js
```

Attach the Bot API directly:

```sh
curl -sS http://127.0.0.1:8788/health
curl -sS http://127.0.0.1:8788/v1/sessions
```

Phone: Build Remote Agent → scan the QR from `gbr-agent pair` (or type the 8-char code). Unpair in Settings before changing PCs.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 English-only doc section breaks locale mirroring

The new Build Remote Agent (phone pairing) section is added only to the English page, with no counterpart in docs/zh/customization/mcp.md. The docs guide requires Chinese as source of truth, edited first and mirrored across locales.

Prompt for agents
docs/AGENTS.md states the Chinese docs are the source of truth for non-changelog pages and that locales must be mirrored (edit docs/zh first, then translate to docs/en). This PR adds a new section only to docs/en/customization/mcp.md. Add the equivalent section to docs/zh/customization/mcp.md so the two locales stay in sync.
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

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