Grok CLI
面向 Grok API 的终端编码代理，支持搜索、子代理与自动化执行。
这个 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。