Grok Remote

Drive Grok Build from your phone or browser — live sessions, tools, history, and control on the same network as your PC.

Companion model: High Poly Rikku by HumanContraband, CC BY 4.0. Clip JSON under clips/ is Mixamo-baked motion for that rig.

_{Desktop · Grok theme · demo data only}

Opt-in hologram in your room (Quest browser or Preview on a 2D screen). Turn it on from Settings → Apps → Companion, then Open companion or the composer XR chip. Remote in the overlay returns to the text UI. Motion service is motion_service.py on port 2423.

python motion_service.py

Windows desktop app (Tauri + WebView2) — wraps a running hub or starts one. Needs grok on PATH.

• Product page: amni-scient.com/grok-remote
• Portable: GrokRemote.exe
• Setup: Grok Remote x64 setup

Hub plugin (phone + browser UI on :2421):

grok plugin install Amnibro/grok-remote --trust
grok plugin enable grok-remote

Pin a release:

grok plugin install Amnibro/grok-remote@v1.9.21 --trust

In the TUI, reload plugins if needed (/plugins → r), then:

/remote

Open the printed URL on your phone (same Wi‑Fi), e.g. http://192.168.x.x:2421/?auto=1.

Linux / macOS: unpack the source tarball, run ./start.sh (Python 3.10+), open the printed URL.

All images below use ?demo=1 sample sessions (titles like Ship remote cockpit polish) — not personal chats or real paths.

Sessions rail + live feed + composer. Tool cards show syntax-colored edits.

Top-right control opens the Command deck: Skills, New task, delivery mode, permission cycle, Tools (Todos / Terminal / Git / Export…), hide/collapse grids, apps, theme, tour.

Scroll the deck for specials — path attach, todos, terminal, git diff, export. (Composer + is attach-only.)

Planet control: Start server, Stop remote, health — without killing your desktop TUI.

Skills sheet merges agent commands + disk skills. Remote also intercepts /effort and /loop (hub scheduler — no CLI window required).

Pick Grok, product accents, or fun skins × light/dark.

Grok (default)	Amni-Scient	Matrix

Ubuntu	Commodore	Grok light

Blur titles, paths, and IDs for safe sharing. Desktop: hold Alt to peek. Phone: private-screen badge.

Chat (Grok)	Command deck	Spoiler	Scient skin

/remote

cd path\to\grok-remote
.\start.ps1 -Cwd path\to\your\project

Download GrokRemote.exe or build:

cd desktop-tauri
npm install
npm run build

Details: desktop-tauri/README.md

Phone / browser  ──HTTP──►  UI + hub  :2421
                 ──WS /ws─►  multi-client hub  ──►  grok agent serve  127.0.0.1:2419
                                                         │
                                                    tools / files on PC

• Hub fans out one agent to many clients (phone + desktop).
• /loop jobs live under ~/.grok/plugin-data/grok-remote/loops.json and fire via the hub.
• Prefer same Wi‑Fi / VPN; don’t expose the agent to the open internet without care.

powershell -File .\scripts\install-autostart.ps1 -Cwd path\to\project
powershell -File .\scripts\install-autostart.ps1 -Boot -Cwd path\to\project
powershell -File .\scripts\install-autostart.ps1 -Disable

Or in TUI: /remote-autostart on · boot · off · status

Config: ~/.grok/plugin-data/grok-remote/config.json (default off).

• Never Stop-Process -Name grok (kills every Grok session on the machine).
• /remote-stop only stops remote UI + remote agent serve.
• Public docs and screenshots use ?demo=1 only — no real session titles or machine paths.

.\start.ps1 -Cwd .
# then, with UI on :2421:
node scripts/capture-screenshots.mjs

Writes docs/screenshots/*.png from demo mode (Grok + theme gallery + phone). Requires Chrome + playwright-core.

See CONTRIBUTING.md and architecture_map.md.

MIT — see LICENSE.