---
slug: "grok-desktop"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/xiaokaige1130-maker/grok-desktop@main/README.md"
repo: "https://github.com/xiaokaige1130-maker/grok-desktop"
source_file: "README.md"
branch: "main"
---
# Grok Desktop

<p align="center">
  <img src="docs/screenshots/app-icon.png" width="104" alt="Grok Desktop icon" />
</p>

<p align="center">
  <strong>A focused desktop workspace for the official Grok CLI</strong><br />
  <strong>基于官方 Grok CLI 的跨平台桌面工作区</strong>
</p>

<p align="center">
  Windows 11 / 10 · macOS · Linux · Multi-session · Plan panel · Diff viewer · MCP · Skills · 中文 / English
</p>

<p align="center">
  <a href="https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest">
    <img src="https://img.shields.io/badge/Download-Windows-1473E6?style=for-the-badge&logo=windows11&logoColor=white" alt="Download for Windows" />
  </a>
  <a href="https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest">
    <img src="https://img.shields.io/badge/Download-macOS-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Download for macOS" />
  </a>
  <a href="https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest">
    <img src="https://img.shields.io/badge/Download-Linux-FCC624?style=for-the-badge&logo=linux&logoColor=111111" alt="Download for Linux" />
  </a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/version-0.8.10-22C55E?style=flat-square" alt="Version 0.8.10" />
  <img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-334155?style=flat-square" alt="Windows, macOS and Linux" />
  <img src="https://img.shields.io/badge/UI-中文%20%7C%20English-E11D48?style=flat-square" alt="Chinese and English UI" />
  <img src="https://img.shields.io/badge/backend-official%20Grok%20CLI-111827?style=flat-square" alt="Official Grok CLI backend" />
</p>

<p align="center">
  <a href="#中文">中文</a> ·
  <a href="#english">English</a> ·
  <a href="https://github.com/xiaokaige1130-maker/grok-desktop/releases">全部版本 / Releases</a> ·
  <a href="./CHANGELOG.md">更新日志 / Changelog</a> ·
  <a href="https://github.com/xiaokaige1130-maker/grok-desktop/issues">问题反馈 / Issues</a>
</p>

![Grok Desktop banner](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/hero.jpg)

## 0.8.10 更新 / What's New

### 中文

`0.8.10` 让聊天输入、长任务和发布体验更完整：图片、文件和文件夹现在都可以直接拖进聊天区，点击 `+` 选择附件的方式仍然保留；窗口最大化时，普通消息、工具总结和图片画廊会自动扩展宽度，恢复正常窗口后回到紧凑布局。消息操作图标、记忆收藏、分支任务和独立会话发送状态也已统一，并修复了 Windows 安装包和桌面快捷方式图标。

### English

`0.8.10` completes the everyday chat workflow: images, files, and folders can be dropped directly into the composer, while the `+` attachment picker remains available. Maximized windows now expand regular messages, tool summaries, and image galleries together, then return to the compact layout when resized. Message actions, memory saves, branch tasks, per-session send state, and the Windows installer/shortcut icon are also aligned and polished.

### 界面预览 / UI Preview

<table>
  <tr>
    <td width="50%"><img src="docs/screenshots/ui-overview-0.8.10.png" alt="Grok Desktop main workspace" /></td>
    <td width="50%"><img src="docs/screenshots/message-actions-0.8.10.png" alt="Message actions and task queue" /></td>
  </tr>
  <tr>
    <td width="50%"><img src="docs/screenshots/environment-0.8.10.png" alt="Environment and version status" /></td>
    <td width="50%"><img src="docs/screenshots/plugins-0.8.10.png" alt="Plugin marketplace" /></td>
  </tr>
</table>

> [!IMPORTANT]
> Grok Desktop 是社区项目，不是 xAI 官方产品。它不内置账号或模型服务，而是连接你电脑上已经安装并登录的官方 `grok` CLI。<br />
> Grok Desktop is a community project, not an official xAI product. It uses the official `grok` CLI installed and authenticated on your computer.

---

<a id="中文"></a>

## 中文

### 一眼看懂

Grok Desktop 把 Grok CLI 的 Agent 能力放进一个适合长期工作的独立窗口。你可以同时运行多个会话，查看文件修改、管理计划、切换模型和权限模式，并继续使用 CLI 已有的 MCP、插件、Skills 与记忆。

它不是网页聊天套壳，也不会替换官方 CLI：

- **Agent 后端**：官方 `grok agent`，通过 ACP 通信。
- **账号与额度**：继续由官方 Grok CLI 和你的 xAI 账号管理。
- **会话与配置**：保存在本机，不需要把 CLI 登录信息交给桌面应用。
- **支持平台**：Windows x64、macOS x64、Linux x64。

### 界面预览

![Grok Desktop 主界面](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/main-ui.png)

<table>
  <tr>
    <td width="50%">
      <strong>多会话工作区</strong><br />
      项目分组、运行状态、历史搜索和后台完成提示集中在左侧。
    </td>
    <td width="50%">
      <strong>计划与上下文</strong><br />
      在同一窗口查看计划进度、工具调用、文件差异和 Agent 输出。
    </td>
  </tr>
  <tr>
    <td colspan="2">
      <img src="docs/screenshots/main-ui-wide.png" alt="Grok Desktop 宽屏工作区" />
    </td>
  </tr>
</table>

### 设置中心

设置页采用独立的分类导航，可以集中管理界面语言、发送方式、通知、更新、模型、记忆、权限、Skills、插件和 MCP 服务。

<table>
  <tr>
    <td width="50%">
      <img src="docs/screenshots/settings-general.png" alt="Grok Desktop 常规设置" />
    </td>
    <td width="50%">
      <img src="docs/screenshots/settings-appearance.png" alt="Grok Desktop 外观设置" />
    </td>
  </tr>
  <tr>
    <td align="center"><strong>常规设置</strong><br />语言、发送方式、思考过程、通知与更新</td>
    <td align="center"><strong>外观设置</strong><br />界面密度、聊天背景、自选图片与背景压暗</td>
  </tr>
</table>

### 核心功能

| 功能 | 能做什么 |
|---|---|
| **多会话并行** | 同时运行多个 Agent 会话；切换页面不会终止后台任务；侧栏显示运行中与已完成状态。 |
| **会话管理** | 新建、恢复、重命名、导出、删除；按工作目录分组；搜索标题与历史。 |
| **会话右键菜单** | 打开、置顶、重命名、导出 Markdown、复制会话 ID/标题/工作目录、在文件夹中显示、归档、删除。 |
| **置顶 / 归档** | 侧栏「置顶」「归档」分组（本地桌面配置，不删 CLI 会话数据）。 |
| **排队与引导** | Agent 工作时 Enter 排队；点「引导」打断并立即发送修正。 |
| **对话气泡** | 用户消息靠右紫色气泡，助手靠左深色卡片；换人说话加大间距。 |
| **可点击链接** | 消息中的 `http(s)` 自动变成超链，用系统浏览器打开。 |
| **计划面板** | 顶栏「计划」+ 数量角标 + 进度；快捷键 `P`。 |
| **文件 Diff** | 工具改文件时行级差异。 |
| **模型与思考强度** | 从 CLI 可用模型中选择并调节强度。 |
| **权限模式** | 审批 / 智能 / 完全访问三档。 |
| **MCP / 插件 / Skills** | 对接官方 CLI；侧栏完整管理，设置页摘要 + 跳转。 |
| **记忆** | 查看与管理跨会话记忆。 |
| **中英界面** | 设置中切换中文 / English。 |
| **关于 / 开发者** | 设置 → 环境：GitHub 主页、反馈、仓库、Release（赞助入口可后续开启）。 |
| **桌面体验** | 完成后通知、首次引导、检查更新、快捷键说明、聊天壁纸。 |

### 排队与“引导”

当 Agent 正在工作时，新消息默认不会粗暴打断当前操作：

1. 输入补充要求并按 **Enter**，消息进入队列。
2. 队列中的内容可以继续编辑或删除。
3. 需要立即改变方向时，点击气泡上的 **引导**，当前运行会被中断并发送该消息。

![排队与引导功能](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/queue-guide-ref.png)

### 权限模式

| 模式 | 行为 | 建议场景 |
|---|---|---|
| **审批模式** | 写文件或运行命令前请求确认。 | 陌生仓库、审查任务、高风险环境。 |
| **智能模式** | 常规操作自动执行，高风险操作继续询问。 | 日常开发，推荐默认使用。 |
| **完全访问** | 默认批准工具操作，可进一步启用更激进的自动执行。 | 完全可信的本机项目。 |

权限可以在 **设置 → 权限** 中随时修改。权限越高，自动执行范围越大；在不了解项目内容时不要直接使用完全访问。

### 个性化背景

在 **设置 → 外观** 中选择渐变、航天主题、自定义图片和背景压暗程度。

| X | Rocket | Orbit | SPACE | Stack |
|:---:|:---:|:---:|:---:|:---:|
| ![X wallpaper](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/wp-x-mark-preview.jpg) | ![Rocket wallpaper](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/wp-rocket-preview.jpg) | ![Orbit wallpaper](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/wp-orbit-preview.jpg) | ![Space wallpaper](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/wp-space-type-preview.jpg) | ![Stack wallpaper](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/wp-stack-preview.jpg) |

### 安装前准备

必须先安装并登录官方 Grok CLI：

```powershell
grok --version
grok login
```

如果 `grok --version` 无法执行，请先按照 [x.ai/cli](https://x.ai/cli) 的官方说明安装 CLI。Grok Desktop 不包含 Grok CLI，也不会绕过官方登录。

### Windows 安装

从 [最新 Release](https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest) 下载以下任一文件：

| 文件 | 适合谁 |
|---|---|
| `Grok-Desktop-*-Windows-Setup-x64.exe` | 推荐。安装到系统，创建开始菜单与桌面快捷方式。 |
| `Grok-Desktop-*-Windows-Portable-x64.exe` | 免安装。适合临时使用或放在自定义目录。 |

首次运行：

1. 在 PowerShell 确认 `grok --version` 正常。
2. 执行 `grok login` 并完成登录。
3. 运行安装版或 portable 版。
4. 在首次引导中检查 CLI 与登录状态。
5. 点击 **新对话**，选择工作目录。

> [!NOTE]
> 当前安装包未使用商业代码签名证书。Windows SmartScreen 可能显示“未知发布者”，请确认文件来自本仓库 Release 后再继续。

#### Windows 找不到 Grok CLI

应用会自动查找常见位置，包括 `%USERPROFILE%\.grok\bin\grok.exe`。如果 CLI 安装在其他目录，可以在 PowerShell 指定完整路径：

```powershell
setx GROK_CLI "C:\完整路径\grok.exe"
```

设置后完全退出并重新打开 Grok Desktop。

### macOS 安装

从 [最新 Release](https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest) 下载：

| 文件 | 说明 |
|---|---|
| `Grok-Desktop-*-macOS-x64.dmg` | 推荐。拖到「应用程序」安装。 |
| `Grok-Desktop-*-macOS-x64.zip` | 解压即用。 |

首次运行：

1. 在终端确认 `grok --version` 正常，并执行 `grok login`。
2. 打开 DMG，将 **Grok Desktop** 拖到「应用程序」。
3. 若系统提示「无法验证开发者」，可在 App 上 **右键 → 打开** 一次，或到「系统设置 → 隐私与安全性」允许。
4. 点击 **新对话**，选择工作目录。

> 当前 Mac 安装包为 **Intel x64**（在 Apple Silicon 上可通过 Rosetta 运行）。应用会自动查找 `~/.grok/bin/grok`、Homebrew 等常见路径；自定义路径可设置环境变量 `GROK_CLI`。

### Linux 安装

从 [最新 Release](https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest) 下载 `.deb`。

Debian / Ubuntu：

```bash
sudo dpkg -i grok-desktop_0.8.4_amd64.deb
sudo apt-get install -f
```

应用会优先查找 `~/.local/bin/grok`，也支持 `/usr/local/bin/grok`、`/usr/bin/grok` 和 `PATH` 中的 `grok`。自定义路径可通过 `GROK_CLI` 环境变量设置。

### 快速使用

1. 点击 **新对话**并选择项目目录。
2. 在输入区描述任务，选择模型和思考强度。
3. 在会话运行时切换到其他会话，后台任务会继续。
4. 打开 **计划**查看步骤，展开工具卡片检查命令和 Diff。
5. 需要补充要求时先排队；需要立刻改变方向时使用 **引导**。
6. 在侧栏会话上 **右键**：导出、复制 ID、归档、置顶等。
7. 完成后可重命名、导出或删除会话。

### 最近更新

完整按版本说明见 **[CHANGELOG.md](https://github.com/xiaokaige1130-maker/grok-desktop/blob/HEAD/CHANGELOG.md)**（中英对照维护）。

| 版本 | 要点 |
|------|------|
| **0.8.9** | 记忆管理 · 消息复制图标 · 带上下文新任务分支 |
| **0.8.8** | Bootstrap 浮层 · 任务/计划/目标三模式 · 全局滚动条 |
| **0.8.7** | Windows 托盘/通知/窗口记忆 · 顶栏工具栏统一 |
| **0.8.5** | macOS 支持（DMG、窗口拖拽、Dock PATH、系统菜单） |
| **0.8.4** | 会话右键菜单、置顶/归档、Skills/插件设置去重 |
| **0.8.3** | 用户/助手左右气泡分色 |
| **0.8.2** | 关于页开发者信息、消息超链可点 |
| **0.8.0** | 顶栏计划、权限三档、中英界面 |

### 数据与隐私

- Grok CLI 登录、会话、模型和额度由官方 CLI 管理。
- 桌面设置只保存在本机用户配置目录。
- 应用不会要求你把 xAI 密码或令牌粘贴到界面中。
- MCP、插件、Skills 和工具调用拥有你授予的本机权限，请只在可信环境中使用高权限模式。

### 常见问题

<details>
<summary><strong>提示“创建失败”或“请先登录官方 Grok CLI”</strong></summary>

先在同一 Windows 用户的 PowerShell 中运行：

```powershell
grok --version
grok login
```

如果 PowerShell 正常但桌面应用仍找不到 CLI，请设置 `GROK_CLI` 为 `grok.exe` 的完整路径并重启应用。
</details>

<details>
<summary><strong>为什么按 Enter 没有立即改变 Agent 的方向？</strong></summary>

Agent 运行时，Enter 的设计是“排队”。点击排队气泡上的“引导”才会中断当前步骤并立即发送。
</details>

<details>
<summary><strong>为什么没有计划内容？</strong></summary>

计划按钮始终可打开，但只有 Agent 创建或更新计划后才会显示条目。简单任务可能不需要计划。
</details>

<details>
<summary><strong>桌面版会影响终端里的 Grok CLI 吗？</strong></summary>

不会替换 CLI。两者共享官方 CLI 的账号和会话数据，因此同一份登录状态可以继续使用。
</details>

---

<a id="english"></a>

## English

### Overview

Grok Desktop turns the official Grok CLI agent into a focused, long-running desktop workspace. Run several sessions in parallel, inspect file changes, follow plans, choose models and permission modes, and keep using your existing MCP servers, plugins, Skills, and memory.

This is not a browser chat wrapper and it does not replace the official CLI:

- **Agent backend:** official `grok agent`, connected through ACP.
- **Account and quota:** managed by the official Grok CLI and your xAI account.
- **Local state:** sessions and desktop preferences remain on your computer.
- **Platforms:** Windows x64, macOS x64, and Linux x64.

### Interface

![Grok Desktop main interface](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/main-ui.png)

The sidebar organizes sessions by workspace and reports background activity. The main area combines the conversation, tool calls, diffs, queued guidance, model controls, and an optional plan panel.

![Grok Desktop wide workspace](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/main-ui-wide.png)

### Settings

The dedicated settings workspace keeps language, input behavior, notifications, updates, models, memory, permissions, Skills, plugins, and MCP servers organized in one place.

<table>
  <tr>
    <td width="50%">
      <img src="docs/screenshots/settings-general.png" alt="Grok Desktop general settings" />
    </td>
    <td width="50%">
      <img src="docs/screenshots/settings-appearance.png" alt="Grok Desktop appearance settings" />
    </td>
  </tr>
  <tr>
    <td align="center"><strong>General</strong><br />Language, input behavior, thinking, notifications, and updates</td>
    <td align="center"><strong>Appearance</strong><br />Density, chat backgrounds, custom images, and dimming</td>
  </tr>
</table>

### Feature Guide

| Feature | Details |
|---|---|
| **Parallel sessions** | Keep multiple agents running at once. Switching views does not stop background work, and the sidebar shows running and completed states. |
| **Session management** | Create, resume, rename, export, and delete sessions. Group them by workspace and search titles or history. |
| **Session context menu** | Right-click: open, pin, rename, export Markdown, copy session ID/title/cwd, reveal in folder, archive, delete. |
| **Pin / archive** | Sidebar groups for pinned and archived sessions (local desktop prefs; does not delete CLI data). |
| **Queue and Guide** | Press Enter to queue a message while the agent is busy. Use Guide to interrupt the current step and send a correction immediately. |
| **Chat bubbles** | User messages on the right (purple); assistant on the left (dark cards); extra spacing when the speaker changes. |
| **Clickable links** | `http(s)` URLs in messages open in the system browser. |
| **Plan panel** | Open the plan from the top bar, review pending and completed steps, and use the `P` shortcut. |
| **File diffs** | Inspect line-level changes produced by tools without leaving the conversation. |
| **Models and effort** | Select from models exposed by your CLI and choose an appropriate reasoning effort. |
| **Access modes** | Switch among Approval, Smart, and Full access based on the trust level of the project. |
| **MCP / plugins / Skills** | Full management in the sidebar; settings show a summary with deep links. |
| **Memory** | Inspect memory state and invoke CLI-backed memory operations. |
| **Bilingual UI** | Switch between Chinese and English from Settings without reinstalling. |
| **About / developer** | Settings → Environment: GitHub profile, feedback, repo, releases (sponsor button reserved). |
| **Desktop polish** | Background completion notifications, first-run diagnostics, update checks, shortcut help, and customizable chat backgrounds. |

### Queue and Guide

When an agent is already working:

1. Type a follow-up and press **Enter** to place it in the queue.
2. Edit or remove queued messages before they are sent.
3. Click **Guide** on a queued message to interrupt the current step and send it now.

![Queue and Guide](https://github.com/xiaokaige1130-maker/grok-desktop/raw/HEAD/docs/screenshots/queue-guide-ref.png)

### Access Modes

| Mode | Behavior | Recommended use |
|---|---|---|
| **Approval** | Requests confirmation before file writes and commands. | Unknown repositories and review work. |
| **Smart** | Runs routine actions automatically and still asks for risky operations. | Recommended for everyday development. |
| **Full access** | Approves tools by default, with an optional more aggressive automation setting. | Fully trusted local projects only. |

Change the mode at any time under **Settings → Permissions**.

### Prerequisite: Official Grok CLI

Install and authenticate the official Grok CLI before launching the desktop app:

```text
grok --version
grok login
```

Follow the official instructions at [x.ai/cli](https://x.ai/cli) if the first command is unavailable. Grok Desktop does not bundle the CLI or bypass official authentication.

### Install on Windows

Download one of these files from the [latest Release](https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest):

| Package | Use |
|---|---|
| `Grok-Desktop-*-Windows-Setup-x64.exe` | Recommended installer with Start menu and desktop shortcuts. |
| `Grok-Desktop-*-Windows-Portable-x64.exe` | Standalone executable that does not require installation. |

Before the first launch, open PowerShell and verify:

```powershell
grok --version
grok login
```

The app automatically checks common locations such as `%USERPROFILE%\.grok\bin\grok.exe`. For a custom installation, set the full path and restart the app:

```powershell
setx GROK_CLI "C:\full\path\to\grok.exe"
```

> [!NOTE]
> The Windows packages are currently unsigned. SmartScreen may display an unknown publisher warning. Verify that the file came from this repository's Release page before continuing.

### Install on macOS

Download from the [latest Release](https://github.com/xiaokaige1130-maker/grok-desktop/releases/latest):

| Package | Use |
|---|---|
| `Grok-Desktop-*-macOS-x64.dmg` | Recommended. Drag into Applications. |
| `Grok-Desktop-*-macOS-x64.zip` | Unzip and run. |

1. In Terminal, run `grok --version` and `grok login`.
2. Open the DMG and drag **Grok Desktop** to Applications.
3. If Gatekeeper blocks the app, use **Right-click → Open** once, or allow it under System Settings → Privacy & Security.
4. Start a new chat and pick a workspace folder.

> macOS builds are **Intel x64** (Apple Silicon runs via Rosetta). The app looks for `~/.grok/bin/grok`, Homebrew, and other common paths; set `GROK_CLI` for a custom location.

### Install on Linux

Debian / Ubuntu:

```bash
sudo dpkg -i grok-desktop_0.8.4_amd64.deb
sudo apt-get install -f
```

The app checks `~/.local/bin/grok`, `/usr/local/bin/grok`, `/usr/bin/grok`, and `PATH`. Set `GROK_CLI` when using a custom location.

### Run From Source

Requirements: Node.js 18+, npm, and an authenticated official Grok CLI.

```bash
git clone https://github.com/xiaokaige1130-maker/grok-desktop.git
cd grok-desktop
npm install
npm start
```

Build packages:

```bash
npm run dist:win       # NSIS installer + portable executable, run on Windows
npm run dist:mac       # DMG + ZIP, run on macOS (x64)
npm run dist:deb       # Debian package, run on Linux
npm run dist:appimage  # AppImage, run on Linux
```

### How It Works

```text
Grok Desktop
  ├─ Electron main process: session pool, IPC, notifications, update checks
  ├─ Renderer: conversations, plans, diffs, settings, search
  ├─ ACP client: structured communication with the agent
  └─ Official Grok CLI: authentication, models, sessions, tools, MCP
```

The desktop app is an interface and orchestration layer. The official CLI remains the source of truth for authentication, model access, and agent execution.

### Recent updates

Full notes: **[CHANGELOG.md](https://github.com/xiaokaige1130-maker/grok-desktop/blob/HEAD/CHANGELOG.md)**.

| Version | Highlights |
|---------|------------|
| **0.8.9** | Memory management · message copy icon · context-aware task branching |
| **0.8.8** | Bootstrap overlays · Task/Plan/Goal modes · global scrollbars |
| **0.8.7** | Windows tray/notifications/window memory · unified top-bar toolbar |
| **0.8.5** | macOS support (DMG, window drag, Dock PATH, app menu) |
| **0.8.4** | Session context menu, pin/archive, Skills/plugins settings cleanup |
| **0.8.3** | Left/right chat bubbles for user vs assistant |
| **0.8.2** | Developer card in About, clickable message links |
| **0.8.0** | Top-bar plan, access modes, zh/en UI |

### Privacy and Security

- Authentication and account state stay with the official Grok CLI.
- Desktop preferences are stored in the current user's local configuration directory.
- The app does not ask you to paste xAI passwords or tokens into its UI.
- Tools, MCP servers, plugins, and Skills can access your computer according to the permission mode you select.

### Troubleshooting

<details>
<summary><strong>Session creation fails or the CLI cannot be found</strong></summary>

Run `grok --version` and `grok login` as the same operating-system user. If they work in PowerShell but not in the app, set `GROK_CLI` to the full executable path and restart Grok Desktop.
</details>

<details>
<summary><strong>Enter did not interrupt the agent</strong></summary>

Enter queues the message by design. Click Guide on the queued bubble to interrupt and send immediately.
</details>

<details>
<summary><strong>The plan panel is empty</strong></summary>

The panel becomes populated after the agent creates or updates a plan. Small tasks may complete without one.
</details>

### Contributing

Bug reports and focused pull requests are welcome through [GitHub Issues](https://github.com/xiaokaige1130-maker/grok-desktop/issues). Include your operating system, Grok CLI version, reproduction steps, and relevant error text.

### Project Notice

- Community-maintained and independent from xAI.
- Grok, xAI, and related names belong to their respective owners.
- Bundled visual presets are original stylistic assets, not official brand artwork.

---

<p align="center">
  <strong>Grok Desktop 0.8.9</strong><br />
  Windows · macOS · Linux, powered by the official Grok CLI.<br />
  <a href="./CHANGELOG.md">Changelog</a>
</p>