remote

name	remote
description	Live phone/browser controller for Grok Build. Use for /remote, Android remote, mobile control, Grok-Remote. Starts LAN UI+ACP proxy with session picker, history+thinking+tools, live stream, Skills, New Task.
argument-hint	[start|stop|status|url|task] [cwd] [message…]
user-invocable	true
disable-model-invocation	false
allowed-tools	["Bash","Read","Glob"]
compatibility	Requires Python 3, grok CLI, Windows PowerShell (start.ps1); aiohttp on first UI start
metadata	{"author":"Anthony","short-description":"Live Android/browser remote for Grok Build","version":"1.1.0"}

Grok Remote (/remote) v1.1

Start (or manage) Grok-Remote: a live phone controller for Grok Build (not history-only).

What it does

1. Runs grok agent --always-approve --leader serve on 127.0.0.1:2419 (tools on this PC).
2. Runs UI + WebSocket proxy on 0.0.0.0:2421 (one phone URL; secret server-side).
3. Phone: session picker, full history (msgs/thoughts/tools/plans), live stream + catch-up poll, Skills palette, New Task (cwd), back-swipe → Sessions.

Plugin paths

• Plugin root: use GROK_PLUGIN_ROOT if set, else the directory that contains start.ps1 / server.py for this plugin.
• Scripts: $PLUGIN/start.ps1, $PLUGIN/server.py, $PLUGIN/web/index.html
• Data/logs: prefer GROK_PLUGIN_DATA when set, else $PLUGIN/logs

Arguments ($ARGUMENTS)

Parse the first token:

Arg	Action
(empty) or start	Start/heal single stack (ensure-running.ps1 -Force -IgnoreConfig) — kills older listeners on control ports first
stop	Run scripts/stop-remote.ps1 — only listeners on 2421 + 2419 (never Stop-Process -Name grok)
status	Run scripts/status-remote.ps1 — loud MODE (HEALTHY / UI_ZOMBIE / STOPPED), ports, PIDs, hub_clients
url	Print the LAN connect URL only
task <cwd> [message…]	Tell the user the phone Task button / deep link for a new session at cwd
extra path	Optional cwd override after the verb

UI stop + pin

• Header Stop posts /api/stack/stop (stops UI + remote agent serve; desktop TUI stays)