Grok CLI
面向 Grok API 的终端编码代理，支持搜索、子代理与自动化执行。
按维度查看评分与理由
证据显示：README 明确说明 API 密钥可通过环境变量、.env 或用户设置提供，并警告 Telegram 令牌要像密码一样对待；提供沙箱模式（--sandbox）以限制主机访问；Telegram 配对需要用户批准；有安全扫描工作流（bun pm untrusted 和 trufflehog）。扣分原因：未详细说明数据流（如哪些数据发送到 xAI、Telegram 或第三方）；未明确所有工具执行前的用户确认机制；依赖众多第三方包，未提供漏洞缓解细节；外部影响（如桌面自动化、网络访问）未充分说明；回滚机制仅提及 uninstall --keep-config，未提供会话或更改回滚。
证据显示：README 和 package.json 一致，命令示例与文档相符；提供故障排除部分，涵盖常见问题；CI 工作流存在。扣分原因：依赖可用性未验证（如 agent-desktop 原生二进制下载可能失败，README 提供了手动步骤）；错误消息仅部分覆盖，未提供所有失败场景的详细说明。
证据显示：面向开发者，提供交互式和 headless 模式，支持多种终端，支持 macOS 和 Linux（沙箱仅限 macOS 14+ Apple Silicon）；明确能力边界（如沙箱限制、计算机子代理仅 macOS）；触发方式明确（自然语言、命令标志）；环境适配良好（提供环境变量和配置文件）。扣分原因：未详细说明所有平台的具体要求（如 Windows 支持有限）；未提供所有场景的配置示例。
证据显示：README 结构清晰，包含安装、运行、配置、故障排除等章节；提供安装脚本和 npm 包；命名稳定（grok 命令）；提供多个示例和 FAQ；明确已知限制（如沙箱仅 macOS）；MIT 许可证；版本号存在（1.1.7）。扣分原因：未提供 CHANGELOG 文件；维护责任不明确（作者为 Vibe Kit，但未说明维护政策）。
证据显示：输出格式多样（文本、JSON 事件流），支持结构化输出；提供独特功能（如 Telegram 远程控制、媒体生成、验证）；成本效益良好（提供 --batch-api 降低费用）。扣分原因：未提供性能基准或用户反馈；未量化成本节省。
证据显示：README 中的声明与代码和配置一致（如模型列表、功能）；提供 CI 和测试脚本；安全扫描工作流存在。扣分原因：未提供测试结果或覆盖率；未提供独立验证；事实与推断未明确区分（如“即将推出”部分）。
- 该工具需要 API 密钥和 Telegram 令牌，请妥善保管，避免泄露。
- 沙箱模式仅适用于 macOS 14+ Apple Silicon，其他平台无法使用。
- 计算机子代理需要 macOS 辅助功能权限，可能带来安全风险。
- 依赖众多第三方包，建议定期运行安全审计。
这个 Agent 能做什么，适合哪些场景？
Grok CLI 是一个以 Bun 和 OpenTUI 构建的交互式终端编码代理，核心调用 xAI 的 Grok API。它既可启动交互式 TUI，也可通过 --prompt 以一次性无头任务方式用于脚本、CI 和自动化。会话可持久化并通过 --session 恢复；--format json 可输出逐行 JSON 事件流。项目还提供默认启用的子代理、MCP 服务器配置、Telegram 远程控制、图像和短视频生成工具，以及面向 macOS Apple Silicon 的 Shuru 沙箱。它适合已采用 Grok API、希望在本地项目目录中运行终端型编码工作流的开发者。
用户运行 grok 或 grok --prompt 后，CLI 将任务发送到配置的 Grok API，并在项目目录中执行编码代理工作流。它提供 search_x 和 search_web 用于检索实时 X 帖子与网页资料，支持 task 前台委派和 delegate 后台只读深度调查；内置 computer 子代理通过 agent-desktop 在 macOS 上执行 computer_snapshot、computer_click、computer_type 与 computer_scroll 等桌面自动化操作。代理会话可保存并由 --session latest 恢复；无头模式的 --format json 会输出 step_start、text、tool_use、step_finish 和 error 等事件。generate_image 与 generate_video 可在聊天会话中生成或编辑媒体，默认保存到 .grok/generated-media/；启用 --verify 或 /verify 时，代理会检查、构建、测试并启动应用，再在沙箱中进行浏览器冒烟检查并产出含截图和视频证据的验证报告。
- 使用 xAI Grok API 的开发者，在终端中让代理检查 package.json、修复测试或重构指定代码。
- CI 或定时脚本维护者，使用 grok --prompt 与 --batch-api 运行可延迟完成的低成本无头任务。
- 需要研究实时 X 帖子和网页资料的工程师，在编码会话中调用 search_x 和 search_web。
- 在 macOS 上需要自动操作本机桌面的开发者，使用 computer 子代理进行无障碍快照与基于引用的点击、输入和滚动。
- 希望在手机上继续驱动仍在运行的本地 CLI 的用户，通过 Telegram 配对并发送文本或语音消息。
这个 Agent 有哪些优点和局限？
- 为 Grok API 专门配置，并提供 grok models 命令查看可用模型及定价提示。
- 同时覆盖交互式 OpenTUI、--prompt 无头运行、会话恢复和逐行 JSON 事件流，便于本地使用与自动化接入。
- 默认支持 task 前台子代理和 delegate 后台只读调查，并允许在 ~/.grok/user-settings.json 定义自定义子代理。
- 提供 search_x、search_web、媒体生成、Telegram 配对和 MCP 配置等已明确记录的扩展能力。
- 核心模型调用依赖 xAI 的 Grok API 和有效的 GROK_API_KEY，不是多模型或多供应商代理。
- 交互式体验依赖现代终端模拟器；README 仅明确推荐 WezTerm、Alacritty、Ghostty 和 Kitty。
- computer 子代理基于 agent-desktop，当前面向 macOS，且要求运行终端具有辅助功能权限。
- Shuru 沙箱只支持 macOS 14 及以上的 Apple Silicon；Intel Mac 和 Linux 无法使用该模式。
- Telegram 远程控制要求自行创建和保护机器人令牌，并且 CLI 进程必须持续运行以进行长轮询。
如何安装或部署这个 Agent？
准备 Grok API key。可执行 curl -fsSL https://raw.githubusercontent.com/superagent-ai/grok-cli/main/install.sh | bash 安装；若 Bun 已在 PATH，也可执行 bun add -g grok-dev。随后设置 export GROK_API_KEY=your_key_here，或使用 grok -k your_key_here 保存密钥。交互式模式需要现代终端模拟器；README 列出的推荐项包括 WezTerm、Alacritty、Ghostty 和 Kitty。
如何使用这个 Agent？
在目标项目目录执行 grok 启动交互式代理，或执行 grok -d /path/to/your/repo 指定目录。一次性无头任务可使用 grok --prompt "run the test suite and summarize failures"；如需机器可读输出，可使用 grok --prompt "summarize the repo state" --format json。用 grok --session latest 续接最近保存的会话；需要验证应用时执行 grok --verify。要启用 MCP，可在 TUI 使用 /mcps，或在 .grok/settings.json 配置 mcpServers。