jakob-bu/grok-bot-linux-unofficial: Unofficial Linux port of the Grok Bot desktop app · GitHub

Unofficial Ubuntu/Linux build of the Grok Bot desktop app.

Cursor ships Grok Bot for macOS and Windows only. This repo does the same
thing the Codex Mac-to-Linux port
did: take the official Electron app, put it on a Linux Electron runtime,
and replace the Windows-only native addons.

It is not an xAI or Cursor product. Linux is unsupported by them.

The official Grok Bot UI — bots, the shared computer, sign-in with your
Cursor account — running as a native Linux app. No Wine.

Current target: Grok Bot 0.29.0 on Electron 42.1.0 (x86_64).

sudo apt install p7zip-full curl unzip build-essential python3 \
  libfuse2 fakeroot
# Node.js 20+ (Ubuntu 24.04: sudo apt install nodejs npm  is too old;
# use https://github.com/nvm-sh/nvm or NodeSource)

git clone <this-repo> grok-bot-linux
cd grok-bot-linux
make build
sudo dpkg -i dist/grok-bot_*_amd64.deb
sudo apt-get install -f -y   # if dpkg reports missing GTK/NSS libs

grok-bot

Or skip the package and run the tree directly:

make build
./dist/Grok_Bot_0.29.0_linux_x64/grok-bot --no-sandbox --ozone-platform-hint=auto

AppImage (needs FUSE 2):

chmod +x dist/Grok_Bot_*_x86_64.AppImage
./dist/Grok_Bot_*_x86_64.AppImage

Sign in with the same Cursor / SuperGrok account you use on the Mac app.
Bots live on the cloud computer; this build is the remote control.

The tarball in dist/ is a self-contained Electron tree. On Fedora /
Arch, install GTK3, NSS, ALSA, and Mesa, then:

tar -xzf dist/Grok_Bot_*_linux_x64.tar.gz
./Grok_Bot_*_linux_x64/grok-bot --no-sandbox --ozone-platform-hint=auto

If Chromium’s sandbox cannot take setuid (containers, some Ubuntu
defaults), the /usr/bin/grok-bot wrapper adds --no-sandbox. Extra
Electron flags go in ~/.config/grok-bot/electron-flags.conf, one per
line.

NVIDIA + black window: add --ozone-platform=x11 to that file.

The in-app updater talks to Windows/macOS feeds and will not install a
Linux build. When Cursor ships a new version:

make detect
make build
sudo dpkg -i dist/grok-bot_*_amd64.deb

The Mac .dmg is not used here. Extracting it on Linux is awkward, and
its native modules are still the wrong ABI. The Windows NSIS installer
unpacks with 7z and is the source every working community port uses.
Details: docs/how-it-works.md.

• x86_64 Linux, glibc 2.34+ (Ubuntu 22.04 or newer)
• Eligible Grok Bot plan (same as the official apps)
• Build machine: p7zip-full, curl, unzip, g++, python3, Node 20+

This repository never commits the official installer, app.asar, or
built binaries. Those are produced on your machine.

Scripts and Linux-native sources in this repo: MIT.

Grok Bot belongs to xAI / Cursor. Electron belongs to the Electron
project. See NOTICE.md.