Grok Desktop

Release macOS 14+ Swift SwiftUI ACP License

A native macOS SwiftUI client for Grok and Grok Build.

• Chat embeds grok.com in the window.
• Build talks to your local grok CLI over ACP. Sessions, skills, Imagine, and config stay in ~/.grok.

This entire app was built with Grok Build on Grok 4.6.

Community project. Not an official xAI / SpaceXAI product.

Grok Desktop Build window

Download: Grok-Desktop-0.1.24.zip · All releases · Changelog

0.1.24: click anywhere on a sidebar session or project row to open it.

1. macOS 14+
2. Unzip and move Grok Desktop.app to Applications
3. Official Grok Build CLI
4. A grok.com account (grok login) or XAI_API_KEY

curl -fsSL https://x.ai/cli/install.sh | bash
grok login

Grok Desktop does not ship the grok binary. It looks on PATH, then ~/.local/bin/grok, ~/.grok/bin/grok, /opt/homebrew/bin/grok, and /usr/local/bin/grok.

The zip is unsigned unless a release says otherwise. First open: right-click the app → Open.

If it won't install, won't open, or you want a feature: open an issue.

Chat can sign in on grok.com inside the app. Build needs the CLI (and grok login or an API key). Signing in from the app WebView can cover both when you use a grok.com account.

• Sidebar switch: Chat | Build (⌘1 / ⌘2)
• Chat: grok.com. History stays on the web, not mixed with Build sessions.
• Build left: new session, search, Imagine, live agents, history grouped by project folder from ~/.grok/sessions (Codex / Claude style). Opening a past chat shows right away; long sessions load in the background. Adding a named project keeps the folders already inferred from sessions.
• Imagine: local image and short video through the grok agent (/imagine, /imagine-video). Recents come from session images/ folders. This is not grok.com/imagine inside Chat.
• Build center: conversation, Markdown, clickable files/links. Thinking and tool rows follow the Grok Build TUI. A sent prompt shows up right away, with Received — thinking... until grok answers. Drag-select copies. Scroll away and a down arrow jumps back to the latest message. The latest prompt can be put back in the composer.
• Build inspector: context, tasks, plan, diffs, live terminals, and this-turn status. /btw / ⌘⇧B opens a Codex-style aside composer; side questions stay out of the main thread.
• Settings: account, appearance, behavior, extensions, grok CLI updates — reads ~/.grok/config.toml

Command Line Tools are enough. Xcode.app is not required.

swift build -c release
./scripts/bundle.sh
open "dist/Grok Desktop.app"

swift run GrokDesktop
swift run GrokDesktopSmoke

There is no XCTest target. Smoke lives in GrokDesktopSmoke.

Release zip (unsigned unless you have a Developer ID):

./scripts/release.sh
./scripts/release.sh --publish # GitHub release

To notarize, set SIGN_IDENTITY to a Developer ID Application identity and NOTARY_PROFILE to a stored notarytool profile, then run ./scripts/release.sh --publish.

Apache-2.0. See LICENSE.

Grok, Grok Build, and grok.com are trademarks of their owners.