Grok Bot Desktop Companion puts your Grok Bots on the Omarchy desktop as floating characters

“My Grok Bots have escaped onto my Omarchy desktop,” Tom Ballard wrote on X on October 31, 2026, announcing the first release of Grok Bot Desktop Companion. Version 0.1.0 brings “floating companions with their own look, per-bot chats and eyes that follow you around.” The idea, in his words: “Connect your bots, pick your favourite, get back to building.”

According to the v0.1.0 release notes and the README, the companion sits in a corner of the screen and opens a speech bubble when you click it, so you can ask a question without leaving what you’re doing. It syncs the saved bot roster from the Grok Bot desktop app, and each bot can take one of 14 avatar shapes and 11 colours, with adjustable motion, size and placement. Pointer-following eyes and a persistent name badge give each bot a presence. You can drag it anywhere, and clicks outside the bubble pass straight through to your work.

Every bot gets its own conversation. The plugin keeps separate history and drafts for each one, shows unread indicators when a bot you’ve switched away from replies, and offers a Stop button plus clear-with-Undo.

There are two ways to get answers. You can connect a Grok Bot webhook routine for real replies from your bots, or fall back on an installed and authenticated local coding agent. The README is upfront that agent mode is your local agent “answering in the bot’s name, not the Grok Bot itself”. It can target grok, claude, codex, opencode, gemini and several others. Files and images can be attached in local-agent mode only, and you can dictate with Superwhisper or Voxtype, with optional routing of finished dictation by bot name, so “Hey OmaBot” goes straight to that bot.

The plugin targets Omarchy 4 with Hyprland and Quickshell, and Python 3 is required for its helpers. Install it with omarchy plugin add https://github.com/tcballard/omarchy-plugin-grokbot-desktop --enable, sign in to the Grok Bot desktop app, let its roster load, then open Appearance & bots → Sync bots from Grok Bot. One thing to know: syncing bots does not connect chat. For real replies you run bin/grokbot-connect from the plugin folder and supply the routine’s webhook URL and sender key, as described in the setup guide.

Ballard is clear about the first-release limits. Conversations and drafts disappear when the shell restarts, roster photos aren’t imported, and roster sync reads the desktop app’s local cache rather than the cloud. The release was accepted on an XPS running an Omarchy dev build, which the notes say “does not establish compatibility with every Omarchy 4 release”.

The companion idea isn’t new on Omarchy, and Ballard credits its inspirations: Clippy for Omarchy and Clanky. He first teased the plugin on October 28, writing that Grok Bot “escaped the browser and moved onto my desktop.” Three days later, it’s yours to try. The plugin is MIT licensed.

Source: https://github.com/tcballard/omarchy-plugin-grokbot-desktop/releases/tag/v0.1.0