[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-superagent-ai--grok-cli":3,"tool-superagent-ai--grok-cli":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",155373,2,"2026-04-14T11:34:08",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":77,"owner_twitter":78,"owner_website":79,"owner_url":80,"languages":81,"stars":90,"forks":91,"last_commit_at":92,"license":93,"difficulty_score":32,"env_os":94,"env_gpu":95,"env_ram":95,"env_deps":96,"category_tags":103,"github_topics":104,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":112,"updated_at":113,"faqs":114,"releases":144},7435,"superagent-ai\u002Fgrok-cli","grok-cli","An open-source autonomous agent powered by Grok.","grok-cli 是一款由社区构建的开源命令行智能体，核心驱动力来自 xAI 的 Grok 大模型。它旨在解决开发者在编码、调试及项目维护中重复性高、上下文切换频繁的问题，将复杂的 AI 协作能力直接融入终端工作流。\n\n这款工具特别适合习惯使用命令行的开发者、DevOps 工程师及技术研究人员。无论是进行实时代码重构、运行测试套件，还是自动化执行桌面操作（如 macOS 上的截图），grok-cli 都能通过自然语言指令高效完成。其独特亮点在于深度集成了 Grok 的实时 X 搜索与网页搜索能力，默认启用多子代理协作机制，并支持通过 Telegram 实现手机远程操控。此外，它基于 Bun 和 OpenTUI 打造，提供了流畅的交互式终端界面，同时也支持无头模式以适配 CI\u002FCD 流水线或批量任务处理。作为一个非官方但功能强大的辅助工具，grok-cli 让开发者能在熟悉的终端环境中，享受兼具速度与智能的编程体验。","# There are many coding agents. **This one is powered by Grok.**\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Factions\u002Fworkflows\u002Ftypecheck.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Factions\u002Fworkflows\u002Ftypecheck.yml)\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fgrok-dev.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgrok-dev)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](.\u002FLICENSE)\n[![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n[![Bun](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBun-1.x-000000?logo=bun&logoColor=white)](https:\u002F\u002Fbun.sh\u002F)\n\nThe rest borrowed from each other. We borrowed from *all of them*, then wired it to **Grok**—real-time **X search**, **web search**, `grok-code-fast-1` and the full Grok model lineup, **sub-agents on by default**, **remote control via Telegram** (pair once, drive the agent from your phone while the CLI runs), and a terminal UI that doesn’t feel like it was assembled in a hurry.\n\nOpen source. Terminal-native. Built with **Bun** and **OpenTUI**. If you want vibes *and* velocity, you’re in the right repo.\n\nCommunity-built and unofficial. This project is not affiliated with or endorsed by xAI, and it is not the official Grok CLI.\n\n[https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7ca4f6df-50ca-4e9c-91b2-d4abad5c66cb](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7ca4f6df-50ca-4e9c-91b2-d4abad5c66cb)\n\n---\n\n## Install\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fmain\u002Finstall.sh | bash\n```\n\n**Alternative installs** (requires Bun on PATH):\n\n```bash\nbun add -g grok-dev\n```\n\n**Self-management** (script-installed only):\n\n```bash\ngrok update\ngrok uninstall\ngrok uninstall --dry-run\ngrok uninstall --keep-config\n```\n\n**Prerequisites:** a **Grok API key** from [x.ai](https:\u002F\u002Fx.ai) and a modern terminal emulator for the interactive OpenTUI experience. Headless `--prompt` mode does not depend on terminal UI support. If you want host desktop automation via the built-in computer sub-agent, also enable **Accessibility** permission for your terminal app on macOS.\n\n---\n\n## Run it\n\n**Interactive (default)** — launches the OpenTUI coding agent:\n\n```bash\ngrok\n```\n\n### Supported terminals\n\nFor the most reliable interactive OpenTUI experience, use a modern terminal emulator. We currently document and recommend:\n\n- **WezTerm** (cross-platform)\n- **Alacritty** (cross-platform)\n- **Ghostty** (macOS and Linux)\n- **Kitty** (macOS and Linux)\n\nOther modern terminals may work, but these are the terminal apps we currently recommend and document for interactive use.\n\n**Pick a project directory:**\n\n```bash\ngrok -d \u002Fpath\u002Fto\u002Fyour\u002Frepo\n```\n\n**Headless** — one prompt, then exit (scripts, CI, automation):\n\n```bash\ngrok --prompt \"run the test suite and summarize failures\"\ngrok -p \"show me package.json\" --directory \u002Fpath\u002Fto\u002Fproject\ngrok --prompt \"refactor X\" --max-tool-rounds 30\ngrok --prompt \"summarize the repo state\" --format json\ngrok --prompt \"review the repo overnight\" --batch-api\ngrok --verify\n```\n\n`--batch-api` uses xAI's Batch API for lower-cost unattended runs. It is a good\nfit for scripts, CI, schedules, and other non-interactive workflows where a\ndelayed result is fine.\n\n**Continue a saved session:**\n\n```bash\ngrok --session latest\ngrok -s \u003Csession-id>\n```\n\nWorks in interactive mode too—same flag.\n\n**Structured headless output:**\n\n```bash\ngrok --prompt \"summarize the repo state\" --format json\n```\n\n`--format json` emits a newline-delimited JSON event stream instead of the\ndefault human-readable text output. Events are semantic, step-level records such\nas `step_start`, `text`, `tool_use`, `step_finish`, and `error`.\n\n### Computer sub-agent\n\nGrok ships a built-in `**computer**` sub-agent backed by `[agent-desktop](https:\u002F\u002Fgithub.com\u002Flahfir\u002Fagent-desktop)` for host desktop automation on macOS.\n\nAsk for it in natural language, for example:\n\n```bash\ngrok \"Use the computer sub-agent to take a screenshot of my host desktop and tell me what is open.\"\ngrok \"Use the computer sub-agent to launch Google Chrome, snapshot the UI, and tell me which refs correspond to the address bar and tabs.\"\n```\n\nNotes:\n\n- Screenshots are saved under `**.grok\u002Fcomputer\u002F**` by default.\n- The primary workflow is **snapshot -> refs -> action -> snapshot** using `agent-desktop` accessibility snapshots and stable refs like `@e1`.\n- `computer_screenshot` is available for visual confirmation, but the preferred path is `computer_snapshot` plus ref-based actions such as `computer_click`, `computer_type`, and `computer_scroll`.\n- macOS requires **System Settings → Privacy & Security → Accessibility** access for the terminal app running `grok`.\n- `agent-desktop` currently targets **macOS**.\n- If Bun blocks the native binary download during install, run:\n\n```bash\nnode .\u002Fnode_modules\u002Fagent-desktop\u002Fscripts\u002Fpostinstall.js\n```\n\n### Scheduling\n\nSchedules let Grok run a headless prompt on a recurring schedule or once. Ask\nfor it in natural language, for example:\n\n```text\nCreate a schedule named daily-changelog-update that runs every weekday at 9am\nand updates CHANGELOG.md from the latest merged commits.\n```\n\nRecurring schedules require the background daemon:\n\n```bash\ngrok daemon --background\n```\n\nUse `\u002Fschedule` in the TUI to browse saved schedules. One-time schedules start\nimmediately in the background; recurring schedules keep running as long as the\ndaemon is active.\n\n**List Grok models and pricing hints:**\n\n```bash\ngrok models\n```\n\n**Pass an opening message without another prompt:**\n\n```bash\ngrok fix the flaky test in src\u002Ffoo.test.ts\n```\n\n**Generate images or short videos from chat:**\n\n```bash\ngrok \"Generate a retro-futuristic logo for my CLI called Grok Forge\"\ngrok \"Edit .\u002Fassets\u002Fhero.png into a watercolor poster\"\ngrok \"Animate .\u002Fassets\u002Fcover.jpg into a 6 second cinematic push-in\"\n```\n\nImage and video generation are exposed as agent tools inside normal chat sessions.\nYou keep using a text model for the session, and Grok saves generated media under\n`.grok\u002Fgenerated-media\u002F` by default unless you ask for a specific output path.\n\n---\n\n## What you actually get\n\n\n| Thing                             | What it means                                                                                                                                                                                                              |\n| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Grok-native**                   | Defaults tuned for Grok; models like `**grok-code-fast-1`**, `**grok-4-1-fast-reasoning**`, `**grok-4.20-multi-agent-0309**`, plus flagship and fast variants—run `grok models` for the full menu.                         |\n| **X + web search**                | `**search_x`** and `**search_web**` tools—live posts and docs without pretending the internet stopped in 2023.                                                                                                             |\n| **Media generation**              | Built-in `**generate_image`** and `**generate_video**` tools for text-to-image, image editing, text-to-video, and image-to-video flows. Generated files are saved locally so you can reuse them after the xAI URLs expire. |\n| **Sub-agents (default behavior)** | Foreground `**task`** delegation (e.g. explore, general, or computer) plus background `**delegate**` for read-only deep dives—parallelize like you mean it.                                                                |\n| **Verify**                        | `**\u002Fverify`** or `**--verify**` — inspects your app, builds, tests, boots it, and runs browser smoke checks in a sandboxed environment. Screenshots and video included.                                                    |\n| **Computer use**                  | Built-in `**computer`** sub-agent for host desktop automation via `**agent-desktop**`. It prefers semantic accessibility snapshots and stable refs, with screenshots saved under `**.grok\u002Fcomputer\u002F**` when requested.     |\n| **Custom sub-agents**             | Define named agents with `**subAgents`** in `**~\u002F.grok\u002Fuser-settings.json**` and manage them from the TUI with `**\u002Fagents**`.                                                                                              |\n| **Remote control**                | Pair **Telegram** from the TUI (`\u002Fremote-control` → Telegram): DM your bot, `**\u002Fpair`**, approve the code in-terminal. Keep the CLI running while you ping it from your phone.                                             |\n| **No “mystery meat” UI**          | OpenTUI React terminal UI—fast, keyboard-driven, not whatever glitchy thing you’re thinking of.                                                                                                                            |\n| **Skills**                        | Agent Skills under `**.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md`** (project) or `**~\u002F.agents\u002Fskills\u002F**` (user). Use `**\u002Fskills**` in the TUI to list what’s installed.                                                                |\n| **MCPs**                          | Extend with Model Context Protocol servers—configure via `**\u002Fmcps`** in the TUI or `**.grok\u002Fsettings.json**` (`mcpServers`).                                                                                               |\n| **Sessions**                      | Conversations persist; `**--session latest`** picks up where you left off.                                                                                                                                                 |\n| **Headless**                      | `**--prompt`** \u002F `**-p**` for non-interactive runs—pipe it, script it, bench it.                                                                                                                                           |\n| **Hackable**                      | TypeScript, clear agent loop, bash-first tools—fork it, shamelessly.                                                                                                                                                       |\n\n\n### Coming soon\n\n**Deeper autonomous agent testing** — persistent sandbox sessions, richer browser workflows, and stronger \"prove it works\" evidence.\n\n---\n\n## API key (pick one)\n\n**Environment (good for CI):**\n\n```bash\nexport GROK_API_KEY=your_key_here\n```\n\n`**.env**` in the project (see `.env.example` if present):\n\n```bash\nGROK_API_KEY=your_key_here\n```\n\n**CLI once:**\n\n```bash\ngrok -k your_key_here\n```\n\n**Saved in user settings** — `~\u002F.grok\u002Fuser-settings.json`:\n\n```json\n{ \"apiKey\": \"your_key_here\" }\n```\n\nOptional `**subAgents**` — custom foreground sub-agents. Each entry needs `**name**`, `**model**`, and `**instruction**`:\n\n```json\n{\n  \"subAgents\": [\n    {\n      \"name\": \"security-review\",\n      \"model\": \"grok-code-fast-1\",\n      \"instruction\": \"Prioritize security implications and suggest concrete fixes.\"\n    }\n  ]\n}\n```\n\nNames cannot be `general`, `explore`, `vision`, `verify`, or `computer` because those are reserved for the built-in sub-agents.\n\nOptional: `**GROK_BASE_URL**` (default `https:\u002F\u002Fapi.x.ai\u002Fv1`), `**GROK_MODEL**`, `**GROK_MAX_TOKENS**`.\n\n---\n\n## Telegram (remote control) — short version\n\n1. Create a bot with [@BotFather](https:\u002F\u002Ft.me\u002FBotFather), copy the token.\n2. Set `**TELEGRAM_BOT_TOKEN**` or add `**telegram.botToken**` in `~\u002F.grok\u002Fuser-settings.json` (the TUI `**\u002Fremote-control**` flow can save it).\n3. Start `**grok**`, open `**\u002Fremote-control**` → **Telegram** if needed, then in Telegram DM your bot: `**\u002Fpair`**, enter the **6-character code** in the terminal when asked.\n4. First user must be approved once; after that, it’s remembered. **Keep the CLI process running** while you use the bot (long polling lives in that process).\n\n### Voice & audio messages\n\nSend a voice note or audio attachment in Telegram and Grok will transcribe it locally with **[whisper.cpp](https:\u002F\u002Fgithub.com\u002Fggml-org\u002Fwhisper.cpp)** before passing the text to the agent. No cloud STT service is involved — everything runs on your machine.\n\n#### Prerequisites\n\n\n| Dependency      | Why                                                             | Install (macOS)            |\n| --------------- | --------------------------------------------------------------- | -------------------------- |\n| **whisper-cli** | Runs the actual speech-to-text inference                        | `brew install whisper-cpp` |\n| **ffmpeg**      | Converts Telegram voice notes (OGG\u002FOpus) to WAV for whisper.cpp | `brew install ffmpeg`      |\n\n\nAfter installing, verify both are available:\n\n```bash\nwhisper-cli -h\nffmpeg -version\n```\n\n#### Download a Whisper model\n\nGrok CLI auto-downloads the configured model on first use, but you can pre-download it:\n\n```bash\nmkdir -p ~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp\ncurl -L https:\u002F\u002Fhuggingface.co\u002Fggerganov\u002Fwhisper.cpp\u002Fresolve\u002Fmain\u002Fggml-tiny.en.bin \\\n  -o ~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp\u002Fggml-tiny.en.bin\n```\n\nAvailable models (trade size for accuracy): `tiny.en` (75 MB), `base.en` (142 MB), `small.en` (466 MB).\n\n#### Configure in `~\u002F.grok\u002Fuser-settings.json`\n\n```json\n{\n  \"telegram\": {\n    \"botToken\": \"YOUR_BOT_TOKEN\",\n    \"audioInput\": {\n      \"enabled\": true,\n      \"binaryPath\": \"\u002Fopt\u002Fhomebrew\u002Fbin\u002Fwhisper-cli\",\n      \"model\": \"tiny.en\",\n      \"modelPath\": \"~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp\u002Fggml-tiny.en.bin\",\n      \"autoDownloadModel\": true,\n      \"language\": \"en\"\n    }\n  }\n}\n```\n\n\n| Setting             | Default           | Description                                                              |\n| ------------------- | ----------------- | ------------------------------------------------------------------------ |\n| `enabled`           | `true`            | Set to `false` to ignore voice\u002Faudio messages entirely.                  |\n| `binaryPath`        | `whisper-cli`     | Absolute path or command name for the whisper.cpp CLI binary.            |\n| `model`             | `tiny.en`         | Model alias used for auto-download resolution.                           |\n| `modelPath`         | *(auto-resolved)* | Explicit path to a `.bin` model file. Overrides `model` + auto-download. |\n| `autoDownloadModel` | `true`            | Download the model into `~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp` on first use.   |\n| `language`          | `en`              | Whisper language code passed to the CLI.                                 |\n\n\nOptional headless flow when you do not want the TUI open:\n\n```bash\ngrok telegram-bridge\n```\n\nTreat the bot token like a password.\n\n---\n\n## Hooks\n\nHooks execute shell commands at key agent lifecycle events — enforce policies, run linters, trigger tests, or log activity.\n\nConfigure in `~\u002F.grok\u002Fuser-settings.json`:\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"bash\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \".\u002Fscripts\u002Flint-before-edit.sh\",\n            \"timeout\": 10\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\nHook commands receive JSON on **stdin** (event details) and can return JSON on **stdout**. Exit code `0` = success, `2` = block the action, other = non-blocking error.\n\n**Supported events:** `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `UserPromptSubmit`, `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `PreCompact`, `PostCompact`, `Notification`, `InstructionsLoaded`, `CwdChanged`.\n\n---\n\n## Instructions & project brain\n\n- `**AGENTS.md**` — merged from git root down to your cwd (Codex-style; see repo docs). `**AGENTS.override.md**` wins per directory when present.\n\n---\n\n## Project settings\n\nProject file: `**.grok\u002Fsettings.json**` — e.g. the current model for this project.\n\n---\n\n## Sandbox\n\nGrok CLI can run shell commands inside a [Shuru](https:\u002F\u002Fgithub.com\u002Fsuperhq-ai\u002Fshuru) microVM sandbox so the agent can't touch your host filesystem or network.\n\n**Requires macOS 14+ on Apple Silicon.**\n\nEnable it with `--sandbox` on the CLI, or toggle it from the TUI with `\u002Fsandbox`.\n\nWhen sandbox mode is active you can configure:\n\n- **Network** — off by default; enable with `--allow-net`, restrict with `--allow-host`\n- **Port forwards** — `--port 8080:80`\n- **Resource limits** — CPUs, memory, disk size (via settings or `\u002Fsandbox` panel)\n- **Checkpoints** — start from a saved environment snapshot\n- **Secrets** — inject API keys without exposing them inside the VM\n\nAll settings are saved in `~\u002F.grok\u002Fuser-settings.json` (user) and `.grok\u002Fsettings.json` (project).\n\n### Verify\n\nRun `**\u002Fverify`** in the TUI or `**--verify**` on the CLI to verify your app locally:\n\n```bash\ngrok --verify\ngrok -d \u002Fpath\u002Fto\u002Fyour\u002Fapp --verify\n```\n\nThe agent inspects your project, figures out how to build and run it, spins up a sandbox, and produces a verification report with screenshots and video evidence. Works with any app type.\n\n---\n\n## Development\n\nFrom a clone:\n\n```bash\nbun install\nbun run build\nbun run start\n# or: node dist\u002Findex.js\n```\n\nOther useful commands:\n\n```bash\nbun run dev      # run from source (Bun)\nbun run typecheck\nbun run lint\n```\n\n---\n\n## License\n\nMIT\n","# 有许多编码代理。**这个由 Grok 提供支持。**\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Factions\u002Fworkflows\u002Ftypecheck.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Factions\u002Fworkflows\u002Ftypecheck.yml)\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fgrok-dev.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgrok-dev)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](.\u002FLICENSE)\n[![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n[![Bun](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBun-1.x-000000?logo=bun&logoColor=white)](https:\u002F\u002Fbun.sh\u002F)\n\n其余部分则互相借鉴。我们从*所有这些项目*中汲取灵感，然后将其与**Grok**连接起来——实时**X 搜索**、**网页搜索**、`grok-code-fast-1` 以及完整的 Grok 模型系列，**默认启用子代理**，**通过 Telegram 远程控制**（只需配对一次，即可在 CLI 运行时通过手机操控代理），还有一个不会让人觉得仓促拼凑而成的终端 UI。\n\n开源。原生终端。使用 **Bun** 和 **OpenTUI** 构建。如果你既想要氛围感又追求速度，那么你来对了仓库。\n\n社区共建且非官方。本项目与 xAI 无任何关联，也未获得其认可，并非官方的 Grok CLI。\n\n[https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7ca4f6df-50ca-4e9c-91b2-d4abad5c66cb](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7ca4f6df-50ca-4e9c-91b2-d4abad5c66cb)\n\n---\n\n## 安装\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fmain\u002Finstall.sh | bash\n```\n\n**替代安装方式**（需要将 Bun 添加到 PATH）：\n\n```bash\nbun add -g grok-dev\n```\n\n**自我管理**（仅限脚本安装）：\n\n```bash\ngrok update\ngrok uninstall\ngrok uninstall --dry-run\ngrok uninstall --keep-config\n```\n\n**先决条件：** 一个来自 [x.ai](https:\u002F\u002Fx.ai) 的 **Grok API 密钥**，以及用于交互式 OpenTUI 体验的现代终端模拟器。无头 `--prompt` 模式并不依赖于终端 UI 支持。如果你想通过内置的计算机子代理实现主机桌面自动化，还请在 macOS 上为你的终端应用启用 **辅助功能** 权限。\n\n---\n\n## 运行它\n\n**交互式（默认）** — 启动 OpenTUI 编码代理：\n\n```bash\ngrok\n```\n\n### 支持的终端\n\n为了获得最可靠的交互式 OpenTUI 体验，请使用现代终端模拟器。目前我们记录并推荐以下几种：\n\n- **WezTerm**（跨平台）\n- **Alacritty**（跨平台）\n- **Ghostty**（macOS 和 Linux）\n- **Kitty**（macOS 和 Linux）\n\n其他现代终端也可能适用，但这些是我们目前推荐并记录用于交互式使用的终端应用。\n\n**选择项目目录：**\n\n```bash\ngrok -d \u002Fpath\u002Fto\u002Fyour\u002Frepo\n```\n\n**无头模式** — 一个提示后退出（脚本、CI、自动化）：\n\n```bash\ngrok --prompt \"运行测试套件并总结失败\"\ngrok -p \"给我看看 package.json\" --directory \u002Fpath\u002Fto\u002Fproject\ngrok --prompt \"重构 X\" --max-tool-rounds 30\ngrok --prompt \"总结仓库状态\" --format json\ngrok --prompt \"整夜审查仓库\" --batch-api\ngrok --verify\n```\n\n`--batch-api` 使用 xAI 的批量 API，以更低的成本进行无人值守的运行。它非常适合脚本、CI、定时任务以及其他不需要即时结果的非交互式工作流。\n\n**继续已保存的会话：**\n\n```bash\ngrok --session latest\ngrok -s \u003Csession-id>\n```\n\n同样适用于交互式模式——使用相同的标志。\n\n**结构化无头输出：**\n\n```bash\ngrok --prompt \"总结仓库状态\" --format json\n```\n\n`--format json` 会输出以换行符分隔的 JSON 事件流，而不是默认的人类可读文本输出。这些事件是语义化的步骤级记录，例如 `step_start`、`text`、`tool_use`、`step_finish` 和 `error`。\n\n### 计算机子代理\n\nGrok 自带一个由 `[agent-desktop](https:\u002F\u002Fgithub.com\u002Flahfir\u002Fagent-desktop)` 支持的内置 `**computer**` 子代理，用于在 macOS 上实现主机桌面自动化。\n\n你可以用自然语言请求它，例如：\n\n```bash\ngrok \"使用计算机子代理截取我的主机桌面截图，并告诉我当前打开了哪些内容。\"\ngrok \"使用计算机子代理打开 Google Chrome，拍摄界面快照，并告诉我地址栏和标签页分别对应哪些引用。\"\n```\n\n注意事项：\n\n- 截图默认保存在 `**.grok\u002Fcomputer\u002F**` 目录下。\n- 主要的工作流程是 **截图 -> 引用 -> 操作 -> 截图**，利用 `agent-desktop` 的辅助功能截图和稳定的引用，如 `@e1`。\n- `computer_screenshot` 可用于视觉确认，但更推荐的方式是使用 `computer_snapshot` 结合基于引用的操作，如 `computer_click`、`computer_type` 和 `computer_scroll`。\n- 在 macOS 上，终端应用运行 `grok` 时需要 **系统设置 → 隐私与安全性 → 辅助功能** 的访问权限。\n- `agent-desktop` 目前仅支持 **macOS**。\n- 如果在安装过程中 Bun 阻止了原生二进制文件的下载，请运行：\n\n```bash\nnode .\u002Fnode_modules\u002Fagent-desktop\u002Fscripts\u002Fpostinstall.js\n```\n\n### 定时任务\n\n定时任务可以让 Grok 按照固定的时间表或一次性地运行无头提示。你可以用自然语言来请求，例如：\n\n```text\n创建一个名为 daily-changelog-update 的定时任务，每周工作日早上 9 点运行，\n并根据最新的合并提交更新 CHANGELOG.md 文件。\n```\n\n重复性的定时任务需要后台守护进程：\n\n```bash\ngrok daemon --background\n```\n\n在 TUI 中使用 `\u002Fschedule` 可以浏览已保存的定时任务。一次性任务会立即在后台开始执行；而重复性任务则会在守护进程保持运行期间持续执行。\n\n**列出 Grok 模型及定价提示：**\n\n```bash\ngrok models\n```\n\n**无需额外提示直接传递开场白：**\n\n```bash\ngrok 修复 src\u002Ffoo.test.ts 中的不稳定测试\n```\n\n**从聊天中生成图片或短视频：**\n\n```bash\ngrok \"为我的名为 Grok Forge 的命令行工具设计一个复古未来主义的 logo\"\ngrok \"将 .\u002Fassets\u002Fhero.png 编辑成一幅水彩海报\"\ngrok \"将 .\u002Fassets\u002Fcover.jpg 动画化为一段 6 秒的电影级推入镜头\"\n```\n\n图像和视频生成作为代理工具嵌入到正常的聊天会话中。你会继续使用文本模型进行会话，而生成的媒体默认会保存在 `.grok\u002Fgenerated-media\u002F` 目录下，除非你指定了特定的输出路径。\n\n---\n\n## 你实际能获得的内容\n\n\n| 项目                             | 含义                                                                                                                                                                                                              |\n| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Grok原生**                   | 针对Grok优化的默认配置；包括诸如`**grok-code-fast-1**`、`**grok-4-1-fast-reasoning**`、`**grok-4.20-multi-agent-0309**`等模型，以及旗舰版和快速版——运行`grok models`即可查看完整列表。                         |\n| **X + 网络搜索**                | `**search_x**` 和 `**search_web**` 工具——实时获取帖子和文档，无需假装互联网停留在2023年。                                                                                                             |\n| **媒体生成**              | 内置的`**generate_image**` 和 `**generate_video**` 工具，支持文生图、图像编辑、文生视频和图生视频流程。生成的文件会本地保存，以便在xAI URL失效后仍可重复使用。 |\n| **子代理（默认行为）** | 前台`**task**`委派（例如探索、通用或计算机任务），加上后台`**delegate**`用于只读深度分析——真正实现并行化操作。                                                                |\n| **验证**                        | `**\u002Fverify**` 或 `**--verify**` — 检查你的应用，构建、测试、启动，并在沙盒环境中运行浏览器冒烟测试。包含截图和视频。                                                    |\n| **计算机使用**                  | 内置的`**computer**`子代理，通过`**agent-desktop**`实现主机桌面自动化。它优先使用语义化的无障碍快照和稳定引用，必要时会在`**.grok\u002Fcomputer\u002F**`目录下保存截图。     |\n| **自定义子代理**             | 在`**~\u002F.grok\u002Fuser-settings.json**`中使用`**subAgents**`定义命名代理，并通过TUI中的`**\u002Fagents**`进行管理。                                                                                              |\n| **远程控制**                | 从TUI配对**Telegram**（`\u002Fremote-control` → Telegram）：向机器人发送私信，输入`**\u002Fpair**`，并在终端确认代码。保持CLI运行，同时可用手机与之交互。                                             |\n| **无“隐藏式”界面**          | OpenTUI React终端界面——快速、键盘驱动，绝非你想象中的那些卡顿工具。                                                                                                                            |\n| **技能**                        | 代理技能位于`**.agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md**`（项目级）或`**~\u002F.agents\u002Fskills\u002F**`（用户级）。使用TUI中的`**\u002Fskills**`可列出已安装的技能。                                                                |\n| **MCPs**                          | 可通过模型上下文协议服务器扩展功能——可通过TUI中的`**\u002Fmcps**`或`**.grok\u002Fsettings.json**`（`mcpServers`）进行配置。                                                                                               |\n| **会话**                      | 对话状态持久保留；`**--session latest**`会从上次中断的地方继续。                                                                                                                                                 |\n| **无头模式**                      | 使用`**--prompt**` \u002F `**-p**`进行非交互式运行——可管道处理、脚本化或基准测试。                                                                                                                                           |\n| **可 hack**                      | TypeScript、清晰的代理循环、以Bash为主的工具——随意fork，大胆使用。                                                                                                                                                       |\n\n\n### 即将推出\n\n**更深入的自主代理测试** — 持久化的沙盒会话、更丰富的浏览器工作流，以及更强有力的“证明其有效”的证据。\n\n---\n\n## API密钥（任选其一）\n\n**环境变量（适合CI）：**\n\n```bash\nexport GROK_API_KEY=your_key_here\n```\n\n项目中的`**.env**`文件（如有`.env.example`，请参考）：\n\n```bash\nGROK_API_KEY=your_key_here\n```\n\n**CLI一次性设置：**\n\n```bash\ngrok -k your_key_here\n```\n\n**保存在用户设置中** — `~\u002F.grok\u002Fuser-settings.json`：\n\n```json\n{ \"apiKey\": \"your_key_here\" }\n```\n\n可选的`**subAgents**`——自定义前台子代理。每个条目需包含`**name**`、`**model**`和`**instruction**`：\n\n```json\n{\n  \"subAgents\": [\n    {\n      \"name\": \"security-review\",\n      \"model\": \"grok-code-fast-1\",\n      \"instruction\": \"优先考虑安全影响，并提出具体的修复建议。\"\n    }\n  ]\n}\n```\n\n代理名称不能为`general`、`explore`、`vision`、`verify`或`computer`，因为这些名称已被内置子代理预留。\n\n可选：`**GROK_BASE_URL**`（默认`https:\u002F\u002Fapi.x.ai\u002Fv1`）、`**GROK_MODEL**`、`**GROK_MAX_TOKENS**`。\n\n---\n\n## Telegram（远程控制）——简要说明\n\n1. 使用[@BotFather](https:\u002F\u002Ft.me\u002FBotFather)创建一个机器人，复制令牌。\n2. 设置`**TELEGRAM_BOT_TOKEN**`，或将`**telegram.botToken**`添加到`~\u002F.grok\u002Fuser-settings.json`中（TUI中的`**\u002Fremote-control**`流程也可保存）。\n3. 启动`**grok**`，必要时打开`**\u002Fremote-control**` → **Telegram**，然后在Telegram中向机器人发送私信：`**\u002Fpair``，并在终端提示时输入**6位字符代码**。\n4. 第一位用户需要手动批准一次，之后系统会记住该用户。**请保持CLI进程运行**，以便持续使用机器人（长轮询功能依赖于该进程）。\n\n### 语音与音频消息\n\n在 Telegram 中发送语音消息或音频附件，Grok 会使用 **[whisper.cpp](https:\u002F\u002Fgithub.com\u002Fggml-org\u002Fwhisper.cpp)** 在本地将其转录为文本，然后再将文本传递给代理。整个过程不涉及任何云端的语音识别服务——一切都在你的设备上运行。\n\n#### 前置条件\n\n\n| 依赖项      | 作用                                                             | 安装（macOS）            |\n| --------------- | --------------------------------------------------------------- | -------------------------- |\n| **whisper-cli** | 执行实际的语音转文本推理                                        | `brew install whisper-cpp` |\n| **ffmpeg**      | 将 Telegram 的语音消息（OGG\u002FOpus 格式）转换为 whisper.cpp 可接受的 WAV 格式 | `brew install ffmpeg`      |\n\n\n安装完成后，请验证两者是否可用：\n\n```bash\nwhisper-cli -h\nffmpeg -version\n```\n\n#### 下载 Whisper 模型\n\nGrok CLI 会在首次使用时自动下载配置的模型，但你也可以提前下载：\n\n```bash\nmkdir -p ~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp\ncurl -L https:\u002F\u002Fhuggingface.co\u002Fggerganov\u002Fwhisper.cpp\u002Fresolve\u002Fmain\u002Fggml-tiny.en.bin \\\n  -o ~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp\u002Fggml-tiny.en.bin\n```\n\n可用的模型（大小与准确率成反比）：`tiny.en`（75 MB）、`base.en`（142 MB）、`small.en`（466 MB）。\n\n#### 在 `~\u002F.grok\u002Fuser-settings.json` 中配置\n\n```json\n{\n  \"telegram\": {\n    \"botToken\": \"YOUR_BOT_TOKEN\",\n    \"audioInput\": {\n      \"enabled\": true,\n      \"binaryPath\": \"\u002Fopt\u002Fhomebrew\u002Fbin\u002Fwhisper-cli\",\n      \"model\": \"tiny.en\",\n      \"modelPath\": \"~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp\u002Fggml-tiny.en.bin\",\n      \"autoDownloadModel\": true,\n      \"language\": \"en\"\n    }\n  }\n}\n```\n\n\n| 设置             | 默认值           | 描述                                                              |\n| ------------------- | ----------------- | ------------------------------------------------------------------------ |\n| `enabled`           | `true`            | 设置为 `false` 可以完全忽略语音\u002F音频消息。                  |\n| `binaryPath`        | `whisper-cli`     | whisper.cpp CLI 二进制文件的绝对路径或命令名。            |\n| `model`             | `tiny.en`         | 用于自动下载解析的模型别名。                           |\n| `modelPath`         | *(自动解析)* | 显式指定 `.bin` 模型文件的路径。会覆盖 `model` 和自动下载设置。 |\n| `autoDownloadModel` | `true`            | 在首次使用时将模型下载到 `~\u002F.grok\u002Fmodels\u002Fstt\u002Fwhisper.cpp` 目录中。   |\n| `language`          | `en`              | 传递给 CLI 的 Whisper 语言代码。                                 |\n\n\n如果你不想打开 TUI 界面，可以使用无头模式：\n\n```bash\ngrok telegram-bridge\n```\n\n请将机器人令牌视为密码。\n\n---\n\n## 钩子\n\n钩子可以在代理生命周期的关键事件触发时执行 Shell 命令——例如强制执行策略、运行代码检查工具、触发测试或记录活动。\n\n在 `~\u002F.grok\u002Fuser-settings.json` 中进行配置：\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"bash\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \".\u002Fscripts\u002Flint-before-edit.sh\",\n            \"timeout\": 10\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n钩子命令会从 **stdin** 接收 JSON 数据（包含事件详情），并可以从 **stdout** 返回 JSON 数据。退出码 `0` 表示成功，`2` 表示阻止操作，其他值表示非阻塞错误。\n\n**支持的事件：** `PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`UserPromptSubmit`、`SessionStart`、`SessionEnd`、`Stop`、`StopFailure`、`SubagentStart`、`SubagentStop`、`TaskCreated`、`TaskCompleted`、`PreCompact`、`PostCompact`、`Notification`、`InstructionsLoaded`、`CwdChanged`。\n\n---\n\n## 指令与项目知识库\n\n- `**AGENTS.md**` — 从 Git 仓库根目录合并到当前工作目录的内容（类似 Codex 风格；详见仓库文档）。如果某个目录下存在 `**AGENTS.override.md**` 文件，则优先使用该文件。\n\n---\n\n## 项目设置\n\n项目文件：`**.grok\u002Fsettings.json**` — 例如，用于指定该项目使用的模型。\n\n---\n\n## 沙盒\n\nGrok CLI 可以在 [Shuru](https:\u002F\u002Fgithub.com\u002Fsuperhq-ai\u002Fshuru) 微虚拟机沙盒中运行 Shell 命令，从而确保代理无法访问宿主机的文件系统或网络。\n\n**需要 macOS 14+ 且搭载 Apple Silicon 芯片。**\n\n通过命令行参数 `--sandbox` 启用，或者在 TUI 中使用 `\u002Fsandbox` 切换。\n\n当沙盒模式启用时，你可以配置以下内容：\n\n- **网络** — 默认关闭；可通过 `--allow-net` 开启，并使用 `--allow-host` 进行限制。\n- **端口转发** — `--port 8080:80`\n- **资源限制** — CPU、内存、磁盘空间（可通过设置或 `\u002Fsandbox` 面板调整）。\n- **检查点** — 从保存的环境快照启动。\n- **密钥** — 注入 API 密钥，而无需在虚拟机内部暴露它们。\n\n所有设置都会保存在 `~\u002F.grok\u002Fuser-settings.json`（用户级）和 `.grok\u002Fsettings.json`（项目级）中。\n\n### 验证\n\n在 TUI 中运行 `**\u002Fverify**` 或在命令行中使用 `**--verify**` 来本地验证你的应用：\n\n```bash\ngrok --verify\ngrok -d \u002Fpath\u002Fto\u002Fyour\u002Fapp --verify\n```\n\n代理会检查你的项目，确定如何构建和运行它，然后启动一个沙盒环境，并生成包含截图和视频证据的验证报告。适用于任何类型的应用程序。\n\n---\n\n## 开发\n\n从克隆的代码库开始：\n\n```bash\nbun install\nbun run build\nbun run start\n# 或：node dist\u002Findex.js\n```\n\n其他常用命令：\n\n```bash\nbun run dev      # 从源代码运行（Bun）\nbun run typecheck\nbun run lint\n```\n\n---\n\n## 许可证\n\nMIT","# grok-cli 快速上手指南\n\n`grok-cli` 是一个基于 Grok 模型的开源终端 AI 编程助手。它集成了实时 X (Twitter) 搜索、网页搜索、多智能体协作、桌面自动化控制以及 Telegram 远程控制等功能，专为追求高效开发的开发者设计。\n\n## 环境准备\n\n在开始之前，请确保满足以下前置条件：\n\n*   **操作系统**：支持 macOS、Linux 及 Windows（推荐现代终端模拟器）。\n*   **终端模拟器**：为获得最佳的交互式界面 (OpenTUI) 体验，推荐使用以下终端之一：\n    *   **WezTerm** (跨平台)\n    *   **Alacritty** (跨平台)\n    *   **Ghostty** (macOS\u002FLinux)\n    *   **Kitty** (macOS\u002FLinux)\n*   **API Key**：需要从 [x.ai](https:\u002F\u002Fx.ai) 获取有效的 **Grok API Key**。\n*   **权限配置 (macOS 用户)**：若需使用内置的“电脑子智能体”进行桌面自动化操作，需在 `系统设置` -> `隐私与安全性` -> `辅助功能` 中授予终端应用权限。\n\n## 安装步骤\n\n### 方法一：一键脚本安装（推荐）\n\n运行以下命令自动下载并安装：\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fmain\u002Finstall.sh | bash\n```\n\n### 方法二：通过 Bun 安装\n\n如果你已安装 Bun 且将其加入环境变量，可使用以下命令：\n\n```bash\nbun add -g grok-dev\n```\n\n### 验证与管理\n\n安装完成后，可使用以下命令管理工具：\n\n```bash\ngrok update        # 更新版本\ngrok uninstall     # 卸载\n```\n\n## 基本使用\n\n### 1. 配置 API Key\n\n使用前需配置密钥，任选一种方式即可：\n\n*   **环境变量（推荐用于 CI\u002FCD）：**\n    ```bash\n    export GROK_API_KEY=your_key_here\n    ```\n*   **项目本地配置：** 在项目根目录创建 `.env` 文件：\n    ```text\n    GROK_API_KEY=your_key_here\n    ```\n*   **命令行一次性配置：**\n    ```bash\n    grok -k your_key_here\n    ```\n*   **全局配置文件：** 编辑 `~\u002F.grok\u002Fuser-settings.json`：\n    ```json\n    { \"apiKey\": \"your_key_here\" }\n    ```\n\n### 2. 启动交互式模式\n\n进入你的项目目录，直接运行 `grok` 启动带有图形界面的终端助手：\n\n```bash\ncd \u002Fpath\u002Fto\u002Fyour\u002Frepo\ngrok\n```\n\n你也可以指定工作目录启动：\n\n```bash\ngrok -d \u002Fpath\u002Fto\u002Fyour\u002Frepo\n```\n\n### 3. 无头模式 (Headless)\n\n适用于脚本、CI 流程或单次任务执行，执行完毕后自动退出：\n\n```bash\n# 执行测试并总结失败原因\ngrok --prompt \"run the test suite and summarize failures\"\n\n# 查看特定文件\ngrok -p \"show me package.json\" --directory \u002Fpath\u002Fto\u002Fproject\n\n# 限制工具调用轮次\ngrok --prompt \"refactor X\" --max-tool-rounds 30\n\n# 输出 JSON 格式结果（便于程序处理）\ngrok --prompt \"summarize the repo state\" --format json\n```\n\n### 4. 高级功能示例\n\n*   **桌面自动化 (Computer Sub-agent)**：\n    让 Grok 控制你的桌面（需 macOS 辅助功能权限）：\n    ```bash\n    grok \"Use the computer sub-agent to take a screenshot of my host desktop and tell me what is open.\"\n    ```\n\n*   **生成图片\u002F视频**：\n    直接在对话中请求生成媒体文件：\n    ```bash\n    grok \"Generate a retro-futuristic logo for my CLI called Grok Forge\"\n    grok \"Animate .\u002Fassets\u002Fcover.jpg into a 6 second cinematic push-in\"\n    ```\n    *生成的文件默认保存在 `.grok\u002Fgenerated-media\u002F` 目录下。*\n\n*   **恢复会话**：\n    继续上一次的对话上下文：\n    ```bash\n    grok --session latest\n    ```\n\n*   **模型列表查询**：\n    查看当前支持的 Grok 模型及定价提示：\n    ```bash\n    grok models\n    ```","某全栈开发者需要在深夜紧急修复一个涉及前端构建失败和后端接口异常的复杂遗留项目，且手边只有手机可用。\n\n### 没有 grok-cli 时\n- **信息检索割裂**：开发者需手动在搜索引擎、Stack Overflow 和 X 平台之间切换，难以获取最新的框架报错解决方案或实时社区动态。\n- **多步操作繁琐**：修复过程涉及查看日志、定位代码、运行测试和重构，必须反复手动输入命令并复制粘贴上下文，极易出错且耗时。\n- **无法远程接管**：离开电脑后无法继续工作，只能等待回到工位处理，导致紧急故障响应延迟，错过最佳修复窗口。\n- **缺乏自动化闭环**：简单的验证任务（如跑通测试套件）也需要人工全程盯着终端输出，无法实现“下达指令后自动完成”的无人值守模式。\n\n### 使用 grok-cli 后\n- **实时智能搜索**：grok-cli 直接调用 Grok 的实时 X 搜索和网络搜索能力，瞬间聚合最新的技术讨论和官方文档，精准定位罕见报错原因。\n- **自主代理执行**：内置的子代理自动完成从读取日志、修改代码到运行测试的全流程，开发者只需确认最终结果，大幅减少机械性敲击。\n- **移动端远程驱动**：通过 Telegram 配对功能，开发者在手机上即可实时监控终端进度并下发新指令，真正实现随时随地修复线上问题。\n- **低成本批量运行**：利用 `--batch-api` 模式，让 grok-cli 在后台低成本自动执行耗时的代码审查或夜间重构任务，次日直接查看结构化 JSON 报告。\n\ngrok-cli 将分散的开发工具链整合为具备实时感知和远程操控能力的自主代理，让开发者从繁琐的命令行操作中解放出来，专注于核心决策。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsuperagent-ai_grok-cli_2bc2df55.png","superagent-ai","Superagent","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fsuperagent-ai_e2144df5.png","Making AI apps safe",null,"ismail@superagent.sh","superagent_ai","https:\u002F\u002Fsuperagent.sh","https:\u002F\u002Fgithub.com\u002Fsuperagent-ai",[82,86],{"name":83,"color":84,"percentage":85},"TypeScript","#3178c6",99.2,{"name":87,"color":88,"percentage":89},"Shell","#89e051",0.8,2898,356,"2026-04-14T01:01:34","MIT","macOS, Linux","未说明",{"notes":97,"python":95,"dependencies":98},"该工具基于 Bun 运行时而非 Python。推荐使用 WezTerm、Alacritty、Ghostty 或 Kitty 等现代终端模拟器以获得最佳交互体验。若在 macOS 上使用计算机子代理（桌面自动化功能），需在系统设置中授予终端应用“辅助功能”权限。运行需要 xAI 的 Grok API 密钥。",[99,100,101,102],"Bun 1.x","TypeScript 5.9","OpenTUI","agent-desktop (macOS only)",[15,52,14,13,35],[105,106,107,108,109,110,111],"agents","ai","cli","code","grok","xai","coding-agent","2026-03-27T02:49:30.150509","2026-04-14T20:49:46.319059",[115,120,125,130,135,139],{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},33358,"在 PowerShell 中运行时终端闪烁、行为异常或任务中途停止怎么办？","这是一个已知的渲染问题，源于 grok-cli 使用的 'ink' 库在 PowerShell 中的兼容性缺陷。解决方案包括：\n1. 临时方案：尝试使用其他终端模拟器（如 Linux 上的 Tilix 或 WSL）来避免闪烁。\n2. 根本原因：该问题与 ink 渲染程序的长期 Bug 有关，大量数据输出会导致显示风暴并减慢响应速度。\n3. 建议：关注官方更新以修复 ink 库的兼容性问题，或在问题解决前考虑使用其他终端环境。","https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fissues\u002F52",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},33359,"安装后运行 'grok' 报错 'Cannot find module ... grok-agent' 如何解决？","此错误通常发生在旧版本中，由于模块路径解析问题导致。解决方法是升级到最新版本：\n1. 运行命令更新包：`npm install -g @vibe-kit\u002Fgrok-cli@latest`（确保版本号至少为 v0.0.30）。\n2. 该问题已在 v0.0.30 版本中修复，重新安装后即可正常运行。","https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fissues\u002F86",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},33360,"遇到 'Grok API error: 410 Live search is deprecated' 错误如何处理？","这是因为 xAI API 已弃用旧的 'Live search' 功能，强制要求切换到新的 Agent Tools API。\n解决方案：\n1. 务必将 grok-cli 升级到最新发布的版本，维护者已在更新中适配了新的 API 端点。\n2. 如果升级后仍报错，请检查是否使用了不再维护的旧分支，建议直接使用主仓库的最新代码。","https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fissues\u002F139",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},33361,"这个项目还在维护吗？仓库是否已废弃？","项目曾经短暂停滞，但维护者已确认项目“再次活跃”（Alive again）。\n注意：由于原始仓库对新版 xAI API（Responses API）的支持可能存在滞后，如果主仓库更新不及时，社区用户也可以考虑使用功能更全的维护版 Fork（如支持 web_search 和 x_search 工具的分支），但首选仍是等待主仓库的最新发布。","https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fissues\u002F140",{"id":136,"question_zh":137,"answer_zh":138,"source_url":119},33362,"在 WSL 或 Linux 环境下遇到严重的视觉故障和 Token 浪费怎么办？","这是由终端渲染引擎（ink）引起的连锁反应，不仅导致屏幕闪烁，还会造成输出重复、文件损坏以及 Token 的快速消耗。\n建议措施：\n1. 避免在存在渲染冲突的终端配置下长时间运行复杂任务。\n2. 参考 Issue #52 中的讨论，尝试更换终端模拟器（如 Tilix）。\n3. 最彻底的解决办法是等待官方修复 ink 库在特定终端下的渲染 Bug。",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},33363,"使用 bun 或 npm 全局安装后无法启动，提示模块丢失，是环境问题吗？","这通常不是用户的环境配置问题，而是特定版本包的发布缺陷。无论是使用 `bun add -g` 还是 `npm install -g` 都会出现相同的 'ERR_MODULE_NOT_FOUND' 错误。\n解决方法：不要尝试手动修复路径，直接升级到维护者发布的修复版本（v0.0.30 及以上）即可解决该构建问题。","https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fissues\u002F80",[145,150,155,160,165,170,175,180,185,189,194,199,204,209,214,219,224,229,234,239],{"id":146,"version":147,"summary_zh":148,"released_at":149},255556,"grok-dev@1.1.5-rc5","## 变更内容\n* 修复：将 MCP 标准输入输出服务器的 stderr 重定向，以防止日志泄露到 TUI 中，由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F259 中实现。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.5-rc4...grok-dev@1.1.5-rc5","2026-04-13T19:41:44",{"id":151,"version":152,"summary_zh":153,"released_at":154},255557,"grok-dev@1.1.5-rc4","## 变更内容\n* 功能新增：通过用户设置中的 `modeModels`，支持为每个模式配置默认模型，由 @gmgauthier 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F258 中实现。\n\n## 新贡献者\n* @gmgauthier 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F258 中完成了首次贡献。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.5-rc3...grok-dev@1.1.5-rc4","2026-04-11T20:19:01",{"id":156,"version":157,"summary_zh":158,"released_at":159},255558,"grok-dev@1.1.5-rc3","## 变更内容\n* 功能：新增 LSP 支持，包括服务器目录和诊断功能，由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F255 中实现。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.5-rc2...grok-dev@1.1.5-rc3","2026-04-09T07:32:32",{"id":161,"version":162,"summary_zh":163,"released_at":164},255559,"grok-dev@1.1.5-rc2","## 变更内容\n* 功能：通过 AgentKit 添加 x402 支付协议支持，由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F252 中实现。\n* 功能：为 x402 支付添加 brin.sh 安全扫描，由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F253 中实现。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.5-rc1...grok-dev@1.1.5-rc2\n","2026-04-07T11:56:14",{"id":166,"version":167,"summary_zh":168,"released_at":169},255560,"grok-dev@1.1.5-rc1","## 变更内容\n* 功能：新增可编程钩子系统，包含17个生命周期事件，由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F248 中实现。\n* 版本号更新：由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F249 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.4...grok-dev@1.1.5-rc1","2026-04-06T06:11:20",{"id":171,"version":172,"summary_zh":173,"released_at":174},255561,"grok-dev@1.1.4","## 变更内容\n* 功能新增：自动生成的图片和视频将自动在操作系统自带的查看器中打开，由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F244 中实现。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.4-rc5...grok-dev@1.1.4","2026-04-05T11:26:31",{"id":176,"version":177,"summary_zh":178,"released_at":179},255562,"grok-dev@1.1.4-rc5","## 变更内容\n* 修复：在安装脚本中解决 tmp_dir 未绑定变量的错误（#242），由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F243 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.4-rc4...grok-dev@1.1.4-rc5","2026-04-03T10:07:56",{"id":181,"version":182,"summary_zh":183,"released_at":184},255563,"grok-dev@1.1.4-rc4","**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.4-rc3...grok-dev@1.1.4-rc4","2026-04-03T08:16:27",{"id":186,"version":187,"summary_zh":76,"released_at":188},255564,"grok-dev@1.1.4-rc3","2026-04-03T08:06:17",{"id":190,"version":191,"summary_zh":192,"released_at":193},255565,"grok-dev@1.1.4-rc2","**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.4-rc1...grok-dev@1.1.4-rc2","2026-04-03T08:01:57",{"id":195,"version":196,"summary_zh":197,"released_at":198},255566,"grok-dev@1.1.4-rc1","## 变更内容\n* 功能：由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F240 中更新了 verify 命令\n* 功能：由 @homanp 在 https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F241 中添加了二进制发布工作流、安装脚本以及自我管理的 CLI 命令\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.3...grok-dev@1.1.4-rc1","2026-04-03T07:58:59",{"id":200,"version":201,"summary_zh":202,"released_at":203},255567,"grok-dev@1.1.3","## What's Changed\r\n* feat: add @-mention file autocomplete by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F236\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.2...grok-dev@1.1.3","2026-04-01T18:51:10",{"id":205,"version":206,"summary_zh":207,"released_at":208},255568,"grok-dev@1.1.2","## What's Changed\r\n* feat: switch computer sub-agent to agent-desktop by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F233\r\n* chore: remove tracked telegram pair code from repo by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F234\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.1...grok-dev@1.1.2","2026-04-01T12:49:58",{"id":210,"version":211,"summary_zh":212,"released_at":213},255569,"grok-dev@1.1.1","## What's Changed\r\n* feat: add verify workflow with sandboxed testing and browser smoke checks by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F228\r\n* feat: add batch mode for headless Grok CLI runs by @alanzabihi in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F231\r\n\r\n## New Contributors\r\n* @alanzabihi made their first contribution in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F231\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.1.0...grok-dev@1.1.1","2026-04-01T06:08:43",{"id":215,"version":216,"summary_zh":217,"released_at":218},255570,"grok-dev@1.1.0","## What's Changed\r\n* chore: add Brin PR commit security scan by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F220\r\n* Update CHANGELOG.md for recent changes by @shuriken-996 in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F219\r\n* feat: add CLI update checker by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F223\r\n* ci: replace commit scan with PR security scan by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F224\r\n* bump package.json to next version by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F225\r\n* fix issue with schedule modal by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F226\r\n\r\n## New Contributors\r\n* @shuriken-996 made their first contribution in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F219\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.0.0-rc7...grok-dev@1.1.0","2026-03-26T16:56:09",{"id":220,"version":221,"summary_zh":222,"released_at":223},255571,"grok-dev@1.0.0-rc7","## What's Changed\r\n* feat: add built-in telegram-bridge command by @Sunwood-ai-labs in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F211\r\n* docs: update changelog with 1.0.0-rc6 release by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F213\r\n* feat: add scheduled headless runs with daemon and agent tools by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F214\r\n* feat: add Shuru sandbox mode for agent shell execution by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F215\r\n* feat: add configurable sandbox settings (network, resources, ports, secrets) by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F217\r\n\r\n## New Contributors\r\n* @Sunwood-ai-labs made their first contribution in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F211\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.0.0-rc6...grok-dev@1.0.0-rc7","2026-03-25T18:47:01",{"id":225,"version":226,"summary_zh":227,"released_at":228},255572,"grok-dev@1.0.0-rc6","## What's Changed\r\n* fix: show Telegram tool activity in TUI by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F202\r\n* docs: clarify terminal support in README by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F204\r\n* feat: update app UI and add changelog by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F206\r\n* feat: add Grok media tools by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F207\r\n* feat: add built-in Vision sub-agent by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F209\r\n* feat: add Telegram voice\u002Faudio transcription via whisper.cpp by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F210\r\n* feat: send attachments to telegram by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F212\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.0.0-rc5...grok-dev@1.0.0-rc6","2026-03-24T20:00:38",{"id":230,"version":231,"summary_zh":232,"released_at":233},255573,"grok-dev@1.0.0-rc5","## What's Changed\r\n* fix: only send reasoningEffort for grok-3-mini by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F200\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.0.0-rc4...grok-dev@1.0.0-rc5","2026-03-23T13:04:02",{"id":235,"version":236,"summary_zh":237,"released_at":238},255574,"grok-dev@1.0.0-rc4","## What's Changed\r\n* feat: add loading animation on streaming by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F190\r\n* feat: add custom sub-agents with \u002Fagents TUI and reliable interrupt by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F192\r\n* fix: add support for multi-agent Grok models by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F197\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.0.0-rc3...grok-dev@1.0.0-rc4","2026-03-23T08:59:46",{"id":240,"version":241,"summary_zh":242,"released_at":243},255575,"grok-dev@1.0.0-rc3","## What's Changed\r\n* remove grok.md support by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F181\r\n* add support for review command by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F182\r\n* add compaction by @homanp in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F183\r\n* test: add helper coverage for rewrite utilities by @SproutSeeds in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F184\r\n* fix: use package.json version instead of hardcoded \"1.0.0\" by @hnshah in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F188\r\n* feat: add json output mode for headless runs by @SproutSeeds in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F185\r\n\r\n## New Contributors\r\n* @SproutSeeds made their first contribution in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F184\r\n* @hnshah made their first contribution in https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fpull\u002F188\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fsuperagent-ai\u002Fgrok-cli\u002Fcompare\u002Fgrok-dev@1.0.0-rc2...grok-dev@1.0.0-rc3","2026-03-22T19:09:08"]