新会话

我们要构建什么?

点卡片填入输入框,确认后再发送。/ 命令,@ 文件。

本机工作台

给本机 grok 一个桌面

界面吸收 Codex / Grok App 的三栏工作台,视觉是独立的 OpenGrok。Agent 运行时是你已经安装的 grok CLI。

工作台

和软件里同一套界面语言

流式对话、思考折叠、工具步骤、权限审批与 Plan 审阅,全部发生在本机窗口里。

流式对话

思考可折叠,工具步骤可见,权限当场批,Plan 审完再动手。

斜杠与文件

/ 调命令,@ 附加工作区文件。点卡片填入输入框,确认后再发送。

会话与扩展

会话、MCP、插件、工作树、记忆、配置与登录,都在左侧栏。

登录方式

官方浏览器登录,或粘贴 console.x.ai 的 API Key。配额与账号显示在左下角。

多项目文件夹

桌面数据在 %USERPROFILE%\.opengrok,CLI 会话仍走 ~/.grok。

远程访问

局域网或公开地址把工作台开给另一台设备。配对码才能改文件、跑命令。

三步

先有 CLI,再打开窗口

OpenGrok 不内置模型。它通过 ACP(grok agent stdio)驱动本机 grok。

安装 Grok CLI

Windows 用官方安装脚本。装好后本机已有 grok 命令与登录状态。

打开 OpenGrok

安装桌面端,选一个项目文件夹。数据留在本机,不经过第三方中转。

开始构建

新会话、点卡片或直接输入。审查 diff,允许或拒绝工具调用。

获取

下载与运行

当前版本 0.4.0。安装包由 GitHub Actions 在 tag v* 时构建。也可从源码打包。

GitHub 发行页 · 全部安装包

本机需要 Grok CLI

没有 CLI,窗口只是空壳。先装官方 CLI 并完成登录。

irm https://x.ai/cli/install.ps1 | iex
curl -fsSL https://x.ai/cli/install.sh | bash

本地打包

在 OpenGrok 仓库根目录执行,生成当前系统的安装包。

npm install; npm run dev
npm run pack

说明

常见问题

这是 xAI 官方产品吗?

不是。OpenGrok 是独立桌面工作台,非 xAI 官方产品。Agent 运行时是你已经安装的 Grok CLI。

必须安装 Grok CLI 吗?

必须。窗口通过 ACP 连接 grok agent stdio。Windows 可执行:irm https://x.ai/cli/install.ps1 | iex

会话和数据存在哪里?

桌面偏好与项目数据在 %USERPROFILE%\.opengrok。CLI 会话、技能、MCP 仍走 ~/.grok。

支持哪些系统?

Windows 10+(当前主平台),macOS Intel / Apple Silicon,以及 Linux x64(AppImage、deb、rpm、tar.gz)。

如何切换中英文?

点右上角 中 / EN。选择会记在本机。软件设置里同样可以切换简体中文与 English。