← pepefigueroa.com · The Lab
Grok Bot for Stream Deck icon New · Free

Grok Bot for Stream Deck · The Lab

Your Grok Bot bots, on Stream Deck.

Every bot gets a key with its own avatar and a live status. See who's working and who's waiting on you, then call them, mute and hang up without touching the mouse.

v3.1.3 · 300 KB · macOS · Windows (beta) · Stream Deck 7.1 or newer

LIVE · status straight from the Grok Bot app

The keys

One press to any bot.

Drag the keys you want onto your deck. Bot keys draw the same avatar Grok Bot shows in its sidebar, with the same shape and colour.

A Bot key: red flower avatar, Developer, Working

Bot

One bot you choose. Press to call it, or just open its chat. A long press does the other one.

A Bot Slot key with a PIN badge: Chief of Staff

Bot Slot

Fills itself with your bots in sidebar order. Add as many as you like. Long press to pin a favourite to the front.

A Next Page key showing 1/3

Next / Previous Page

More bots than keys? Page through them. The key shows where you are. Long press jumps back to page 1.

The Talk key

Talk

Starts a voice call with the bot that's open. Bot keys can call their bot directly.

The Mute keyThe Mute key showing MUTED

Mute / Unmute

Toggles your mic in the call. The key shows MUTE or MUTED to match.

The End call key

End

Hangs up. In-call keys work without pulling Grok Bot to the front.

The Find keyThe New bot key

Find, New, Dictate

Open search, start a new bot, or dictate into the open chat. Plus keys for Grok Bot's usage and settings pages.

A Bot key showing OFFLINE because Grok Bot is closed

Keys that tell you why

Grok Bot closed? Keys say OFFLINE. A missing bot or a missing permission shows a clear warning instead of failing quietly.

The Bot Switcher on a Stream Deck + touch strip: Developer, Working, 2 of 8

Bot Switcher · Stream Deck +

Turn the dial to browse your bots on the touch strip, press to open one, hold to call it.

Live status

Know who needs you, at a glance.

The plugin reads the status straight from the Grok Bot app on your computer, every couple of seconds.

WORKINGActive in the last two minutes. The avatar wiggles and looks around.
READYUnread messages, or waiting for your reply. Pulses until you press it.
IDLEActive in the last 24 hours.
INACTIVEQuiet for more than a day. Dimmed.
OFFLINEGrok Bot is closed, so the status can't be trusted.

Why I built it

I live in Grok Bot all day. Now every bot sits on a key: I see who's working, who's waiting on me, and I call them with one press.

Pepe Figueroa · video engineer

Install it in a minute.

  1. Download the file and double-click it. Stream Deck asks to install it: click Install. It upgrades older versions and keeps your keys.
  2. In Stream Deck, open the Grok Bot category and drag keys onto your deck. Try a row of Bot Slots plus Next Page.
  3. On a Mac, the first press of Talk, Mute, End, Find, New or Dictate asks for permission. Open System Settings › Privacy & Security › Accessibility, turn on Elgato Stream Deck, and press again. Keys that only open things don't need it.

Needs the Grok Bot desktop app, installed and signed in on the same computer, and Stream Deck 7.1 or newer.

Download v3.1.3

macOS 12+ · Windows 10+ (beta) · 300 KB

Free. If it saves you time, buy me a coffee.

Support

Questions

The plugin reads three small files the Grok Bot app keeps on your computer: your bot list (names, avatars, unread and activity times), which bot is open, and which bots you pinned. It never reads your chats and sends nothing anywhere.

Found a bug or have an idea? Email me with your computer, Stream Deck model and what happened: contact@pepefigueroa.com

Made in The Lab · Pepe Figueroa

Does it work on Windows?

It's built for Windows too, but it hasn't been tested on a PC yet, so it's a beta there. If you try it, email me what worked and what didn't. The plugin's log file in its folder helps.

A key says "Allow access".

Turn on Elgato Stream Deck in System Settings › Privacy & Security › Accessibility, then press the key again. Grok Bot has no shortcuts for calls, so the plugin presses its buttons for you, and macOS asks first.

Mute or End says "No call".

They only work while a voice call is on. Start one with Talk or a Bot key first.

A key says "Bot not found".

That bot was deleted or belongs to another account. Open the key's settings in Stream Deck and pick the bot again.

Why does a key say OFFLINE?

Grok Bot is closed, and it only updates its bot list while it's running. Open Grok Bot and the status comes back on its own.

Will a Grok Bot update break it?

It can. If Grok Bot changes how it stores its bot list or renames its buttons, statuses or calls may stop working until I update the plugin. Opening bots keeps working.

How do I uninstall it?

In Stream Deck, open Preferences › Plugins, select Grok Bot and click the minus button.

Is this made by xAI or Elgato?

No. It's a free, unofficial community plugin. "Grok" and the Grok Bot avatars belong to xAI. It isn't made, endorsed or supported by xAI or Elgato.