Grok App：本地 Grok CLI 桌面工作台

项目简介

Grok App 是一个开源桌面工作台，面向本地 Grok Build CLI（grok agent stdio）用户。它通过 ACP 协议与本地 CLI 深度集成，把会话、项目、文件编辑、媒体预览、自动化与远程控制集中到一个图形界面中。应用本身不捆绑专有模型后端，聊天推理、工具执行和权限都通过已安装的 grok CLI 运行。它不是 xAI 官方产品。

主要功能

• 原生构建会话：与 grok agent stdio 集成，支持 Ask、Allow Once、Allow for Session 和 YOLO 等权限层级；默认启用 Grok 4.7 Extra High（xhigh），也可选择 Grok 4.7 Fast。
• 多项目工作台：提供隔离的项目工作区、文件夹信任、代理状态看板、一键切换 Git Worktree、从任意助手回复分叉会话，以及通过 /attach-chat 或拖拽附加参考会话。
• 实时代理交互：按顺序流式展示思考过程、工具执行和最终回复；支持在代理忙碌时排队后续提示、Ctrl+Enter 引导当前回合、提示历史、引用与行内标注。
• 文件与创作闭环：内置 CodeMirror 6 多标签编辑器，文件与磁盘双向同步；支持可视化 Git Diff、单文件或批量接受/拒绝/回退，以及图片、视频、音频、PDF、Office 文档预览。还可通过 Imagine 技能生成图片和视频。
• 扩展与自动化：对齐 Grok Build 斜杠命令面板，支持技能标签、自定义工作流（/workflow）、MCP 服务器、插件目录、代理与 hooks 管理；支持自然语言创建定时任务并查看执行日志。
• 远程连接：可桥接飞书/Lark、Telegram、Discord、Slack、钉钉、企业微信、微信个人号、QQ、Matrix、LINE、微博等 11+ IM 渠道；提供带令牌保护的移动 Web 镜像和本地 REST 会话 API。
• 账户与个性化：API Key 存放在操作系统钥匙串；提供 SuperGrok 配额进度条和成本热力图，支持 OpenRouter、Requesty、DeepSeek、AI98PRO 等自定义供应商；内置 15 种界面语言和浅色、深色、系统自适应主题。

安装与使用

1. 从官网 grok-app.com 或 GitHub Releases 下载安装包。
   • macOS（Apple Silicon）：Grok_*_aarch64.dmg
   • macOS（Intel）：Grok_*_x64.dmg
   • Windows（x64）：*-setup.exe 或 *-portable.zip
   • Linux（x64）：AppImage、.deb 或 .rpm
2. 启动应用，设置向导会检查 Grok Build CLI 是否已安装。
3. 可选择官方账号登录、填写 API Key、配置自定义中转，或直接使用本地 CLI 已有登录状态。
4. 添加并信任项目工作目录，选择 Ask 或 YOLO 权限模式后开始使用。

预构建安装包不要求本机安装 Node.js、pnpm 或 Rust。使用完整代理能力需要本地已安装并登录 Grok Build CLI，版本要求为 0.2.112 或更高，可在终端运行 grok update 升级。

注意事项

• 本项目不是 xAI 官方产品，不捆绑专有模型后端。
• Windows 需要 WebView2 Runtime；Windows 11 通常已预装，缺失时安装器会引导安装。
• Linux AppImage 需要宿主提供 libEGL.so.1 以及 WebKitGTK 4.1 / Ayatana 等运行时库。
• 在无法直接访问 Grok 服务的网络环境中，可在 Settings → Runtime → Network 配置 HTTP/SOCKS 代理，并用 Test connection 验证。
• macOS 官方版本从 v0.2.19 起使用 Apple Developer ID 签名并完成公证；若遇到 Gatekeeper 拦截，可参考 README 的平台说明。

本作品整理自 GitHub 开源项目 RongleCat/grok-app，原作者 @RongleCat，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。