No VPN · No open ports · Grok is the relay

Your terminals.
On your phone.

Control Grok Build CLI sessions from your phone. Install the free desktop agent on Windows, macOS, or Linux. Pair once. Inject commands. Stream output. Phone and PC never connect directly.

Download free agent Mobile apps Support

1 · Install agent on your PC

Free binary for Windows, macOS, or Linux. One-liner install or direct download.

2 · Pair with the phone

Mobile shows an 8-character code. Run gbr-agent pair -code … on the PC.

3 · Inject & watch

Keep gbr-agent run alive. Swipe sessions on the phone and send commands.

Download free agent — PC · Mac · Linux

Current release: v0.3.1. Source is proprietary; binaries are free for end users. Hosted on this site (no GitHub login required).

Pick your OS below. Install → pair → run. Same CLI on every platform: pair, run, sessions, status, version.
Windows · x64

Windows (PC)

PowerShell 5.1+ · Windows 10/11

One-liner install
irm https://grokbuildremote.com/install.ps1 | iex
Or download binary
Download .exe SHA256
After install — commands
# Open a new PowerShell / Terminal, then:

gbr-agent pair -code YOURCODE
gbr-agent run

# Optional
gbr-agent sessions
gbr-agent status
gbr-agent version
gbr-agent rename -name MyPC
  • pair -code — link phone (code from mobile app, ~10 min TTL)
  • run — start relay loop + session scanner (keep running)
  • Install dir default: %LOCALAPPDATA%\GrokBuildRemote\
macOS · Apple Silicon & Intel

macOS

Terminal · macOS 12+

One-liner install
curl -fsSL https://grokbuildremote.com/install.sh | bash
Or download binary
Apple Silicon (arm64) Intel (amd64) 
# If you downloaded manually:
chmod +x gbr-agent-darwin-arm64
mv gbr-agent-darwin-arm64 ~/.local/bin/gbr-agent
# first launch: System Settings → Privacy → Accessibility (for inject)
After install — commands
gbr-agent pair -code YOURCODE
gbr-agent run

# Optional
gbr-agent sessions
gbr-agent status
gbr-agent version
gbr-agent rename -name MyMac
  • Install dir default: ~/.local/bin/gbr-agent
  • Grant Accessibility when prompted so inject can type into terminals
Linux · x64 & ARM64

Linux

Bash · amd64 / arm64 · xdotool for inject

One-liner install
curl -fsSL https://grokbuildremote.com/install.sh | bash
Or download binary
linux-amd64 linux-arm64 
# Manual:
chmod +x gbr-agent-linux-amd64
mv gbr-agent-linux-amd64 ~/.local/bin/gbr-agent

# Inject helper (Debian/Ubuntu example):
sudo apt install xdotool
After install — commands
gbr-agent pair -code YOURCODE
gbr-agent run

# Optional
gbr-agent sessions
gbr-agent status
gbr-agent version
gbr-agent rename -name MyLinux
  • Install dir default: ~/.local/bin/gbr-agent
  • Run in a graphical session (inject needs your desktop session)

Checksums: SHA256SUMS · Mirror folder: /downloads/latest/ · License: EULA / free binary terms

Agent command reference (all platforms)

Binary name: gbr-agent (Windows: gbr-agent.exe). Protocol: gbr/1.

CommandWhat it does
gbr-agent pair -code CODE Complete pairing with the 8-character code from the mobile app. Optional: -name MyPC
gbr-agent run Start the agent: poll relay, discover sessions, accept inject. Leave this running.
gbr-agent sessions List known terminal sessions (folders, git repos, .grok-session)
gbr-agent status Show device id, mailbox, and health hints
gbr-agent version Print version / OS / arch
gbr-agent rename -name NAME Set display name for this PC
gbr-agent -log=debug run Run with verbose logs
Typical first-time flow
# On PC / Mac / Linux
curl -fsSL https://grokbuildremote.com/install.sh | bash   # or install.ps1 on Windows
gbr-agent pair -code AB12CD34
gbr-agent run

# On phone: open Grok Build Remote → use demo or real paired sessions → type: help

Config lives under ~/.gbr/ (macOS/Linux) or %USERPROFILE%\.gbr\ (Windows). Optional env: GBR_RELAY_URL, GBR_API_KEY / XAI_API_KEY.

How it works

Mobile app and gbr-agent both talk to a durable HTTPS mailbox. Phone and PC never open sockets to each other — works through VPNs and locked-down networks. 

Phone ──HTTPS──► Relay ──HTTPS──► gbr-agent ──► local terminals
  ▲                  │                    │
  └────── output ────┴────────────────────┘
Protocol: gbr/1 · Desktop agent free · Mobile apps $13 paid

Mobile apps — $13 paid

iOS (+ Apple Watch companion)

Paid App Store app · $13.00 USD one-time · SwiftUI · session swipe · pair free desktop agent. Not a free app.

Android

Paid Google Play app · $13.00 USD one-time (or store-closest tier) · same protocol. Not a free app.

Pairing uses the free desktop agent above. Mobile clients are paid products.

Pricing

$13

Mobile apps are paid: $13.00 USD one-time (App Store exact $13.00). Not free. Desktop agent only is free. No subscription.