Skip to content

grok-cli

终端优先、可脚本化、Agent 就绪的 Grok / xAI CLI,集成了 SKILL 和 Rust CLI

Core Features

  • OAuth 认证:SuperGrok 或 X Premium+ 登录,无需 API key
  • 扁平命令面:一个 CLI 搞定 chat、search、image、video、audio、usage
  • 默认流式输出:人类可读文本,--json 适配自动化
  • 媒体输入:本地文件和远程 URL(image、video、audio)
  • 跨平台:macOS Apple Silicon 和 Windows x64 预构建

Installation

bash
# Agent 运行时(推荐)
npx --yes skills add Moore-developers/grok-cli --skill grok-cli --global --yes

# 源码安装(Rust 1.88+)
cargo install --git https://github.com/Moore-developers/grok-cli.git --locked

# Release binary
# 从 GitHub Releases 下载

Commands

CommandDescription
login启动 xAI OAuth 浏览器登录
status检查 OAuth 会话状态
refresh刷新保存的 access token
logout删除本地 auth 状态
chat与 Grok 文本聊天(默认含网络搜索)
search通过 Grok x_search 搜索 X
image生成图片
image-edit编辑参考图片
video生成视频
video-edit编辑视频
video-extend延长视频
tts文本转语音
stt语音转文本
usage显示会话用量和限流快照
model设置默认文本模型

JSON Output

所有命令支持 --json 输出稳定结构化数据:

json
{
  "ok": true,
  "command": "chat",
  "data": {}
}

For AI Agents

为 Codex、Claude Code、Cursor 等 Agent 运行时设计。安装 bundled skill 自动处理认证、命令路由和安装检查:

bash
npx --yes skills add Moore-developers/grok-cli --skill grok-cli --global --yes

State

  • Auth tokens: ~/.grok-cli/auth.json
  • Usage history: ~/.grok-cli/session.db (SQLite)

Resources

Released under the MIT License.