GitHub - jakob-bu/grok-bot-linux-unofficial: Unofficial Linux port of the Grok Bot desktop app
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.
What you get
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#what-you-get) 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).
Ubuntu / Debian
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#ubuntu--debian)
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.
Other distros
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#other-distros) 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
Build options
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#build-options) | Command | Result | | --- | --- | | `make detect` | Newest official Windows version on Cursor's CDN | | `make build` | Tarball + `.deb` + AppImage in `dist/` | | `./scripts/build.sh 0.29.0` | Pin a specific upstream version | | `./scripts/build.sh --exe ~/Downloads/Grok_Bot_0.29.0_Setup.exe` | Use an installer you already downloaded | | `make install-deb` | Build if needed and `dpkg -i` |
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.
Updates
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#updates) 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
How this compares to the Mac app
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#how-this-compares-to-the-mac-app) | | Official Mac app | This Linux build | | --- | --- | --- | | UI / bots / cloud computer | yes | same `app.asar` | | Sign-in | Cursor account | same | | Native addons | Mach-O | rebuilt or replaced for Linux | | Auto-update | official | rebuild from the new Windows installer | | Support | Cursor | none (community) |
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.
Requirements
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#requirements)
- 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.
License
[](https://github.com/jakob-bu/grok-bot-linux-unofficial#license) Scripts and Linux-native sources in this repo: MIT.
Grok Bot belongs to xAI / Cursor. Electron belongs to the Electron project. See NOTICE.md.