grokbot-cdp

grokbot-cdp is a small Python library that attaches to the Grok Bot desktop app's Chrome DevTools port, finds the <webview> carrying the machine's noVNC session, and from there reads the screen, sends clicks and keystrokes, runs shell commands, and places a credential without echoing it. It has two runtime dependencies, requests and websocket-client. The library is not a Claude Code skill or plugin, and it ships no SKILL.md: it is a library you import. It is not a browser automation framework, and it does not wrap one, because the framework everyone reaches for cannot see this target at all. It is not supported by xAI, and it is automation against an interface that was never offered as one, so a change to the app's internals can end it without notice. Most of all it is not a channel that carries stdout. Output comes back as pixels. Nothing here reads a command's exit status or its text, so a command whose result matters has to write somewhere you can reach by another route. The library is designed with three commitments: measured, never inferred; a channel that can lie is made to fail instead; and the narrow credential. It raises rather than hand back a frame it cannot vouch for, and the same instinct runs through the input model and the credential handling. The machine on the far end is shared with every other Bot on the account, files and browser sessions included, so anything put there should be the smallest thing that does the job, should never be painted on the screen on its way in, and should be revocable on its own. The app must be signed in already; this library does not handle login, and should not: that is the one step worth doing yourself.