qervas/remote-grok-build

v0.1.0MIT

Bridge Grok Bot chat to local Grok Build on a linked PC: mission control, streaming turns, interrupt, media packs; optional chief→workers and RGB channel.

GitHub

Remote Grok Build

Grok Bot Agent Plugin (skills-only) that bridges chat to local Grok Build on a linked Windows PC — no public tunnels.

What you get

Mission control (status): LIVE → STALE → idle
Streaming turns, interrupt, after-turn image/git packs
Bidirectional media (session images ↔ chat attachments)
Optional chief → per-project worker bots + optional RGB channel
Idle sessions cold-open with grok --resume (no live hold required)

Install

Marketplace (after listing): Settings → Plugins → search remote-grok-build
From this repo: submit at cursor.com/marketplace/publish, or install locally in Cursor IDE:
```
ln -s /path/to/remote-grok-build ~/.cursor/plugins/local/remote-grok-build
```
Bot template: Add from x.ai — public Grok Bot recipe with the same skill + conventions.

Prerequisites on the linked PC

grok on PATH (~/.grok/bin/grok.exe)
Optional helpers under ~/.grok-bridge/ — see helpers/ and docs/HELPERS.md

Layout

plugin.json
.grok-plugin/plugin.json
skills/remote-grok-build/SKILL.md
helpers/          # optional PowerShell wrappers
docs/

Not included

Secrets, personal machine paths, Cloudflare/ngrok tunnels, Cursor CloudAgent workflows.

License

MIT