Grok Bot
Public Made by Adomby adom
Grok Bridge lets Adom talk to Grok Bot. Adom's AI environment is for electrical engineers: any provider, any desktop power tool, one place.
Skills
The skills this repo ships, by tier, each with a quick health read. Install the user skills with:
adom-wiki skills install adom/grok-bridgeUse this when driving Grok Bot on the user's desktop from the cloud via the grok_* Adom Bridge verbs. Host app is Grok Bot.exe (standalone Electron; Cursor is last-resort fallback only if Grok Bot.exe is missing). Open/close/resize/screenshot/record the app, report thinking vs idle (grok_chat_status), read the visible transcript (grok_chat_read), queue a message (toast + inbox), bind the Grok Bridge webhook and create bots/channels. Sub-skills: grok-app-control, grok-chat, grok-record, grok-webhook, grok-account, grok-anywhere. No public Grok HTTP API — the spawned Python runtime talks back to ab over desktop_* callbacks. Trigger words: grok, grok bot, grok_open, grok_close, grok_chat_status, grok_chat_read, grok_webhook_ensure, grok_webhook_bind, talk to grok, send to grok bot, grok screenshot, grok_computer_screenshot, screenshot_computer, screenshot grok bot computer.
Sign in / sign out of Grok Bot and install plugins without typing passwords. grok_login / grok_logout use the app UI (Sign In with Cursor / Sign Out). grok_plugin_install launches grokbot://app/v1/plugin/add?id=<id> as an exe arg because desktop_open_url refuses grokbot://. Trigger words: grok_login, grok_logout, grok_plugin_install, sign in grok bot, sign out grok bot, install grok plugin.
Grok Bot is an Adom Anywhere character (Claude Desktop / Codex class). This session already has adom-bridge on PATH. Always --ai-thread \"Grok Bot\" and --target when more than one desktop is connected. Prefer ab verbs over Grok ListMachines/Shell so the activity log stays intact. Host app is Grok Bot.exe (standalone Electron). Trigger words: adom anywhere grok, grok bot desktop, drive my pc from grok, adom-bridge from grok bot, grok_webhook_ensure.
Open, close, resize, screenshot, and list Grok Bot.exe windows via grok_* Adom Bridge verbs. Host app is Grok Bot (title exact Grok Bot — not Chrome ai-grok-bot, not bare Grok). Background by default; foreground needs foregroundReason. Cursor is last-resort fallback only. Trigger words: grok_open, grok_close, grok_resize, grok_screenshot, grok_list_windows, grok_status, open grok bot, close grok bot, screenshot grok bot, resize grok window.
Read whether Grok Bot is thinking vs idle (grok_chat_status), pull the visible transcript (grok_chat_read), and queue a message via toast + durable inbox (grok_send — does not type into the composer unless opt-in). Capture is the Grok Bot.exe window via UIA, not OCR-first, never webhook keys. Trigger words: grok_chat_status, grok_chat_read, grok_send, is grok thinking, read grok chat, grok transcript, send a message to grok bot.
Record the Grok Bot.exe window (not the agent-box desktop feed) with grok_record_start / stop / status. grok_record_start requires a reason. Wraps desktop_record_window_* on the Grok Bot hwnd. Trigger words: grok_record_start, grok_record_stop, grok_record_status, record grok bot, grok window recording, demo recording grok.
Bind the Grok Bridge webhook without human copy-paste (grok_webhook_ensure scrapes the routine pane), fire events, and create Grok Bot bots/channels. Screenshot grok-bridge's computer (the agent box, not Grok Bot.exe) with grok_computer_screenshot — one verb, unique nonce, no bash poll. Stores ~/.adom/grok-webhook.json on the PC. Never log or hint the key. Auth on fire is Authorization: Bearer. Trigger words: grok_webhook_ensure, grok_webhook_bind, grok_webhook_fire, grok_webhook_status, grok_bot_create, grok_channel_create, grok_bot_list, grok_computer_screenshot, grok webhook, create grok bot, create grok channel, screenshot_computer, screenshot grok bot computer, grok computer screenshot.
DEV skill for editing grok-bridge (not shipped in the pkg). Architecture of the Python grok_* runtime, LINE OF DEMARCATION with ab-core, hwnd unwrap, webhook scrape, and the rich-hints-in-output rule. Trigger words: grok-dev, grok-bridge architecture, grok hwnd unwrap, grok verb contract, grok desktop callbacks.
PUBLISH skill for grok-bridge (repo only, not in the pkg). How to cut the runtime zip vs the skills pkg, files[] allowlist, .gitignore trap, install.sh skill list, discovery_triggers, and verify. Trigger words: grok-publish, publish grok-bridge, grok-bridge pkg, grok-bridge release zip, grok skills pack.
No publish skills in this repo.
The app-to-wiki publish glue. Source-only (publish-skills/), never shipped in the tarball.
Health: the size chip is green when right-sized, yellow when getting long, red when the model likely skims it. A green check is a passed preamble/structure signal; an amber mark is a gentle nudge, not a hard failure.