FollowAgents AI AGENTS 目录
首页 / 全部 Agents / Grok CLI
开发与工程 grok-apiterminal-uicoding-assistantweb-searchx-searchsubagentstelegram-controlmcp

Grok CLI

面向 Grok API 的终端编码代理，支持搜索、子代理与自动化执行。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
superagent-ai/grok-cli
Star 数
★ 3.5k
最近更新
4 个月前
License
MIT
主语言
TypeScript
FA 评分
53/100 · 缺口较多

30 秒速览

运行形态
命令行工具
可在哪里用
平台专用
费用
软件免费，模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
BunGrok API 密钥用于交互式 OpenTUI 的现代终端模拟器Shell / 命令行网络访问本地文件系统MCP Server
典型场景
使用 xAI Grok API 的开发者，在终端中让代理检查 package.json、修复测试或重构指定代码。
不适合
  • 需要多模型供应商或本地模型、不想绑定 xAI Grok API 的团队
  • 使用 Intel Mac 或 Linux 且需要沙箱隔离运行的开发者
源码审查
53/100 · 缺口较多

这个 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 时，代理会检查、构建、测试并启动应用，再在沙箱中进行浏览器冒烟检查并产出含截图和视频证据的验证报告。

  1. 使用 xAI Grok API 的开发者，在终端中让代理检查 package.json、修复测试或重构指定代码。
  2. CI 或定时脚本维护者，使用 grok --prompt 与 --batch-api 运行可延迟完成的低成本无头任务。
  3. 需要研究实时 X 帖子和网页资料的工程师，在编码会话中调用 search_x 和 search_web。
  4. 在 macOS 上需要自动操作本机桌面的开发者，使用 computer 子代理进行无障碍快照与基于引用的点击、输入和滚动。
  5. 希望在手机上继续驱动仍在运行的本地 CLI 的用户，通过 Telegram 配对并发送文本或语音消息。

如何安装或部署这个 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。

这个 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 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Grok CLI 当前 53 · 缺口较多 命令行工具免费 + 模型费 ★ 3.5k 4 个月前 TypeScript —
Maki 编程智能体 67 · 存在缺口 命令行工具免费 + 模型费 ★ 1.4k 今天 Rust OpenAI API · Claude API
Keen Code 62 · 存在缺口 — ★ 90 今天 Go ChatGPT · OpenAI API · Claude API
Alysis Code 72 · 存在缺口 命令行工具免费版 + 付费版 ★ 213 1 天前 Python OpenAI API · Claude API

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1
缺口较多
53/ 100 五分制 2.7 / 5
信任安全 14/29
可靠稳定 6/14
适用触发 12/18
规范维护 10/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

证据显示其具有沙箱选项、首次工作区模式确认、Telegram 配对审批、API 密钥设置说明及卸载/干运行选项，因此普通使用的确认与恢复措施较充分。扣分原因：host 模式、shell hooks、桌面自动化、MCP 和子代理都可带来较宽权限；密钥虽被要求视为密码，但示例允许命令行和用户设置保存，未展示加密或访问控制；联网搜索、语音转写、Telegram 远控及依赖审计的具体覆盖有限。README 清楚说明项目与 xAI 无关联，包元数据提供作者字段，但发布者身份未验证。

可靠稳定6 / 14 · 2.1/5

README、package.json 与 AGENTS.md 对 Bun、构建和常用命令大体一致，并给出了 API 缺失、终端兼容、沙箱平台限制等错误处理线索。扣分原因：AGENTS.md 明确记载 lint 配置与开发模式存在问题，且其对 CI 检查的说法与 README 的徽章/脚本信息不能完全交叉确认；项目依赖众多外部 API、包及桌面原生组件，材料未说明可用性保障。

适用触发12 / 18 · 3.3/5

文档覆盖交互式与 headless、脚本/CI、会话续接、调度、媒体生成、搜索、远控及桌面自动化，并标出 macOS Apple Silicon 沙箱和 macOS 桌面自动化边界。扣分原因：多项能力需外部 API、权限、运行中的进程或特定终端；样本未充分说明每种模式的能力差异和降级路径。

规范维护10 / 18 · 2.8/5

README 按安装、运行、配置、功能及故障排查组织，提供较多命令示例和常见问题；包名、CLI 名称与版本字段可辨识。扣分原因：MIT 许可证文件版权年份和持有人仍为占位符；提供的材料没有实际变更日志；维护责任主要由仓库/包元数据暗示，未给出明确维护团队或响应承诺。

有效结果7 / 13 · 2.7/5

headless 文本与 JSONL 输出、会话保存、工具调用及生成媒体落盘等设计可支持后续脚本和复用；搜索、子代理与验证流程提供了明确的编码工作流价值。扣分原因：有用性主要由 README 声称，材料未证明执行结果；Batch API 延迟、API 费用、工具轮次和持续运行成本虽有部分提示，但未充分量化。

证据核验4 / 8 · 2.5/5

README 将安装、配置和功能主张对应到具体命令与设置项，AGENTS.md 对已知开发问题给出具体位置与症状。扣分原因：许多产品主张在提供的代码样本中未见对应实现或独立佐证；本审查未运行项目，且 README 的 CI 徽章本身不能验证此修订的行为。

风险与缓解建议
  • 在允许访问主机文件、网络或桌面之前，先确认沙箱模式、hooks、MCP 与子代理配置；Telegram bot token 和 Grok API key 应按凭据管理。
  • README 记录沙箱仅支持 macOS Apple Silicon，桌面自动化仅面向 macOS；AGENTS.md 还指出开发模式和 lint 存在问题。
  • MIT 许可证中的版权年份和持有人仍是占位符；提供的材料没有变更日志或维护响应承诺。
证据充分度：低 评估于 2026年11月7日 审查版本 fb97af83f06d
评估证据 README.mdAGENTS.mdagent-browser/SKILL.mdagent-desktop/SKILL.mdfind-skills/SKILL.mdsrc/index.tshooks/index.tsstorage/index.tsLICENSEpackage.jsonworkflows/release.ymlworkflows/security.yml
查看完整评分方法 →
你是这个项目的维护者？把 FARS 徽章加到 README

徽章显示当前的评审分数和结论，点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/grok-cli.svg?lang=zh)](https://followagents.com/zh/agents/grok-cli)
<a href="https://followagents.com/zh/agents/grok-cli"><img src="https://followagents.com/badge/grok-cli.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

  1. [email protected]
    发布说明摘录
    What's Changed * feat: add recaps toggle by @homanp in https://github.com/superagent-ai/grok-cli/pull/311 * feat: prompt for workspace sandbox trust by @zxyasfas in https://github.com/superagent-ai/grok-cli/pull/291 New Contributors * @zxyasfas made their first contribution in https://github.com/superagent-ai/grok-cli/pull/291 Full Changelog: https://github.com/superagent-ai/grok-cli/compare/[email protected]@1.1.7 What's Changed * feat: add recaps toggle by @homanp in https://github.com/superagent-ai/grok-cli/pull/311 …
    在 GitHub 查看 ↗
  2. [email protected]
    发布说明摘录
    What's Changed * chore(release): add sigstore build-provenance attestations by @veetihietasalo in https://github.com/superagent-ai/grok-cli/pull/271 * docs: update CHANGELOG from merged PRs by @homanp in https://github.com/superagent-ai/grok-cli/pull/275 * docs: add troubleshooting section with common issues and solutions by @meichuanyi in https://github.com/superagent-ai/grok-cli/pull/277 * docs: add trademark disclaimer and remove brand-confusing language by @alanzabihi in https://github.com/superagent-ai/grok-cli/pull/281 …
    在 GitHub 查看 ↗
  3. [email protected]
    发布说明摘录
    What's Changed * feat: replace whisper.cpp with Grok STT for Telegram audio (#265) by @homanp in https://github.com/superagent-ai/grok-cli/pull/266 * fix(release): mark RC tags as GitHub prereleases by @veetihietasalo in https://github.com/superagent-ai/grok-cli/pull/268 * chore(install): warn when auto-resolving to a pre-release version by @veetihietasalo in https://github.com/superagent-ai/grok-cli/pull/269 New Contributors * @veetihietasalo made their first contribution in https://github.com/superagent-ai/grok-cli/pull/268 …
    在 GitHub 查看 ↗

常见问题

使用它需要付费吗？
必须具备有效的 Grok API key。项目提供 grok models 查看模型和定价提示，--batch-api 被说明为适合可接受延迟结果的较低成本无头运行方式；源码材料未给出具体价格。
它能在 CI 中运行吗？
可以。设置 GROK_API_KEY 后，可用 grok --prompt 执行一次性任务，并可配合 --format json 或 --batch-api 用于脚本、CI、计划任务等非交互式流程。
沙箱在哪些机器可用？
内置 Shuru 微虚拟机沙箱要求 macOS 14+ 和 Apple Silicon。Intel Mac 或 Linux 不能使用 --sandbox，但可使用标准非沙箱模式。
桌面自动化需要哪些权限？
computer 子代理当前针对 macOS，运行 grok 的终端应用需要在“系统设置 → 隐私与安全性 → 辅助功能”中获得权限。
无头 JSON 输出是什么格式？
--format json 输出逐行 JSON 事件流，而不是人类可读文本；事件包括 step_start、text、tool_use、step_finish 和 error。
这页内容对你有帮助吗？
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审，横向比较这个 Agent 所属的短名单。

开源编程 Agent 横向对比

按 FARS 评审排序的开源编程 agent——分数、信任、许可证、语言与维护状态并排比较，并说明各自擅长与不擅长什么。

MCP Agent 横向对比

提供或调用 Model Context Protocol 服务的 agent，按 FARS 评审排序，并列出许可证、维护状态与信任分。