grok-app
v0.1.3Grok App / Grok Desktop — unofficial native GUI over official Grok Build CLI (ACP). English + 中文. Rust/egui.
Grok App / Grok Desktop
Unofficial native desktop client for the official Grok Build CLI (grok agent stdio · ACP).
Not affiliated with xAI. “Grok” is a trademark of xAI. This project is a community GUI shell over the published CLI.
┌─────────────────┐ ACP JSON-RPC ┌──────────────────────┐
│ Grok Desktop │ ───────────────────► │ grok agent stdio │
│ (this app) │ ◄─────────────────── │ (official CLI) │
└─────────────────┘ session/update └──────────────────────┘
| Repo | qingchencloud/grok-app (public) |
| UI language | English (default) · 中文 — Settings → Appearance → Language |
| 中文文档 | docs/zh/README.md |
| Download | Releases — Setup.exe installer |
| How to cut a release | docs/RELEASE.md |
| Config reference | docs/CONFIGURATION.md |
| What not to upload | docs/REPO_HYGIENE.md |
| Landing page | https://qingchencloud.github.io/grok-app/ · source preview/ |
Screenshots
English UI · light mode · empty chat with suggestion chips
中文界面 · 日间模式 · 空会话与快捷入口
More images live under docs/screenshots/.
Download (end users)
- Open Releases
- Pick a version
- Windows (recommended): download
GrokDesktop-Setup-<ver>-windows-x64.exe
→ double-click → Install (no zip, no unpack) - Or portable:
GrokDesktop-<ver>-windows-x64.exe(single file, run directly) - macOS:
GrokDesktop-<ver>-macos-*(single binary) - Install & login CLI if needed:
# Windows
irm https://x.ai/cli/install.ps1 | iex
grok login
# macOS / Linux
curl -fsSL https://x.ai/cli/install.sh | bash
grok login
Features
| Area | Notes |
|---|---|
| Agent | Manages grok agent stdio |
| Chat | Streaming replies, thoughts, tools, plans |
| Sessions | App-owned index + import from CLI ~/.grok/sessions |
| Model / cwd | Top bar + settings |
| Permissions | Always-approve or interactive |
| Images | Paste / attach / drag-drop as ACP image blocks |
| CLI install | One-click install from settings (Windows) |
| Config map | Settings write ~/.grok/config.toml carefully |
Requirements
- Grok Build CLI
grok loginonce- Rust toolchain only if building from source
Build from source
git clone https://github.com/qingchencloud/grok-app.git
cd grok-app
cargo run --bin GrokDesktop
cargo test --test core_logic
cargo build --release
# → target/release/GrokDesktop(.exe)
Windows packaging:
.\packaging\build-release.ps1
# → dist\GrokDesktop-<ver>-windows-x64-*.zip
CI & releases
| Workflow | Trigger | Output |
|---|---|---|
| CI | push / PR | Tests + build check |
| Release | tag v*.*.* or manual |
GitHub Release with downloadable zips |
| Pages | preview/** |
Static landing (enable Pages in settings) |
Publish a version:
git tag v0.1.0
git push origin v0.1.0
# or: Actions → Release → Run workflow → version 0.1.0
See docs/RELEASE.md.
Configuration
User settings live outside the repo (%APPDATA%\GrokApp\config.json).
Auth lives in ~/.grok/auth.json (CLI). Never commit secrets.
Defaults (model list, install URL, etc.) are documented in docs/CONFIGURATION.md.
Topics / keywords
grok · grok-app · grok-desktop · GrokDesktop · xai · ACP · agent-client-protocol · rust · egui · eframe · desktop · ai-agent · coding-agent · cli · stdio · qingchencloud
License
MIT — see LICENSE.