KayG is an independent, open-source Grok Build GUI and cross-platform Grok desktop client from Technodweep. It gives the Grok Build CLI a native visual interface on Linux, macOS, and Windows, powered by Tauri 2, React, Rust, and the Agent Client Protocol (ACP).
Website: kayg.technodweep.com
Important
KayG is an independent community project. It is not affiliated with, endorsed by, or sponsored by xAI. Grok and Grok Build are trademarks of xAI.
KayG is a visual shell for the Grok Build coding agent. The Grok CLI remains
the brain and continues to own authentication, tools, MCP servers, sessions,
and model access. KayG launches grok agent stdio and communicates with it over
ACP, adding a desktop workflow without reimplementing the agent.
Unlike a wrapper around grok.com, KayG is designed specifically as a GUI
for the Grok Build CLI and its coding-agent workflows.
KayG desktop app <── Agent Client Protocol ──> Grok Build CLI <──> xAI
Click the preview to watch the full-quality video.
Visit the official KayG website for product information, demos, and downloads.
Download KayG for Windows x64 (.msi)
No administrator privileges required. Windows 10/11.
Note
KayG v0.1.0 is available now. Download the Windows installer above or browse the GitHub release for all platform packages.
Release tags beginning with v automatically build KayG packages for Linux,
macOS, and Windows and publish them to
GitHub Releases.
For source builds, follow the instructions below.
| Platform | Packages |
|---|---|
| Linux | .deb, .rpm, .AppImage |
| macOS | .app, .dmg |
| Windows | Download x64 MSI installer - NSIS .exe, .msi |
- Chat with streaming replies, thinking, tool cards, plans, and elicitation
- Permissions (Ask / Auto / Always), plan mode, compact / rewind / fork
- Sessions: resume / rename / delete; multi-agent dashboard
- Composer:
/commands,@files, image attach, queue, fuzzy history - Hubs: Extensions (MCP/skills/plugins), Agents, Tasks, Memory, Account, Rules
- Agent terminals (live panel + tool-card embed), workflows / loops / goals
- Memory (
/remember, browse, flush/dream) and media (/imaginegallery) - Project
AGENTS.mdeditor and custom model endpoints inconfig.toml - Context and usage, find-in-scrollback, raw Markdown, and themes
- Login, logout, doctor, and sandbox controls without returning to the TUI
- Grok CLI 0.2.x or newer on
PATH(or at~/.grok/bin/grok) - An authenticated Grok session or an
XAI_API_KEY
curl -fsSL https://x.ai/cli/install.sh | bash
grok --version- Rust stable (
rustup) - Node.js 22 or newer
pnpm
Linux builds also require WebKitGTK, GTK, and the standard Tauri system dependencies listed under Linux development dependencies.
No. KayG is an independent Technodweep community project. It is compatible with the Grok Build CLI but is not affiliated with, endorsed by, or sponsored by xAI.
No. KayG connects to grok agent stdio over ACP and presents the Grok Build
coding agent as a native desktop application.
No. Install and authenticate the Grok CLI separately. Any Grok account, subscription, API access, and usage charges remain between you and xAI.
KayG is designed for Linux, macOS, and Windows. The release workflow builds native packages for all three platforms.
Yes. Set XAI_API_KEY, or authenticate by running grok in a terminal before
opening KayG.
pnpm install --dir apps/desktop
pnpm devpnpm dev uses ./scripts/dev.sh, which configures the GTK/WebKit environment
when needed. To start Tauri without the helper, use pnpm dev:raw.
sudo apt update
sudo apt install -y \
libwebkit2gtk-4.1-dev libgtk-3-dev librsvg2-dev \
patchelf libayatana-appindicator3-dev build-essential \
curl wget file libssl-dev libxdo-dev pkg-configIf system development packages are unavailable, ./scripts/dev.sh can use
dependencies under ~/.local/tauri-deps.
Blank WebKit window on Linux: KayG sets
WEBKIT_DISABLE_DMABUF_RENDERER=1 by default. The Vite development URL already
uses 127.0.0.1 for better WebKit compatibility.
./scripts/ci-local.sh
# or
pnpm ci# Linux (from the repository root)
./scripts/build-linux.sh
# target/release/bundle/{deb,appimage,rpm}/
# macOS
cd apps/desktop && pnpm tauri build --bundles app,dmg
# Windows
cd apps/desktop && pnpm tauri build --bundles nsis,msiSee the packaging guide for platform-specific details.
- Changelog — v0.1.0 notes
- Architecture — desktop and ACP design
- Shipped ACP surface checklist — supported protocol surface
- Full feature parity plan — phases A–I inventory
- Multi-repository workspaces plan — workspace dashboard and delivery phases
- Packaging — Linux, macOS, and Windows builds
apps/desktop/ Tauri app (React UI + Rust backend)
docs/ Architecture, ACP checklist, and packaging
scripts/ Local CI and Linux build helpers
.github/workflows/ CI and cross-platform releases
| Environment variable | Meaning |
|---|---|
GROK_HOME |
Override the Grok config/session root (default ~/.grok) |
GROK_BINARY |
Path to the grok binary |
XAI_API_KEY |
API-key authentication, optional when browser auth exists |
RUST_LOG |
Tracing filter, for example info,kayg_lib=debug |
GUI settings such as theme, binary override, and last project live in
~/.grok/gui/settings.json.
- The default permission mode is Ask.
- Client filesystem handlers are sandboxed to the session project directory.
- Enabling “Always approve tools” explicitly opts new and resumed connections into automatic tool approval.
Issues and pull requests are welcome. Please describe the user problem, keep
changes focused, and run pnpm ci before submitting a pull request.
KayG is created and maintained by Technodweep. Visit our website to explore our other products and engineering work.
KayG source code and documentation are licensed under the Apache License 2.0. See NOTICE for attribution.
The KayG name, logo, and application icons are Technodweep brand assets and are covered by the KayG trademark and brand policy, not by the Apache License 2.0. Grok and Grok Build are trademarks of xAI.