中文说明

Grok / xAI in a terminal-first, scriptable, and agent-ready CLI.

• OAuth-only auth — sign in with SuperGrok or X Premium+, no API key needed.
• Flat command surface — one CLI for chat, search, image, video, audio, and usage.
• Streaming by default — readable text for humans, --json for automation.
• Media inputs — local files and remote URLs for image, video, and audio.
• Cross-platform — pre-built for macOS Apple Silicon and Windows x64.

# Agent runtime (recommended)
npx --yes skills add Moore-developers/grok-cli --skill grok-cli --global --yes

# From source (Rust 1.88+)
cargo install --git https://github.com/Moore-developers/grok-cli.git --locked

# Release binary
# Download from GitHub Releases

Source installs require Rust 1.88+ (toolchain pinned to 1.92.0). On macOS Apple Silicon and Windows x64, the bundled skill prefers the release binary.

Release assets:

• macOS Apple Silicon: grok-cli-macos-aarch64-apple-darwin.tar.gz
• Windows x64: grok-cli-windows-x86_64-pc-windows-msvc.zip

After installation, check for CLI updates with:

grok-cli update --check

Run grok-cli update to install a newer release when available. Passive update notices are low-frequency and never appear in --json or raw stream output. Disable them with grok-cli update --no-update-check, re-enable them with grok-cli update --enable-update-check, or temporarily suppress them with GROK_CLI_NO_UPDATE_CHECK=1.

# 1. Log in with your browser
grok-cli login

# 2. Verify the session
grok-cli status

# 3. Run your first task
grok-cli chat "Summarize the latest AI news"

# 4. Check usage
grok-cli usage

Headless environment? Use grok-cli login --manual-paste for a code-based login flow.

# Stream a response (default)
grok-cli chat "What's new in AI?"
grok-cli search "Thoughts on Grok 3?"

# Non-streaming
grok-cli chat "Summarize AI news" --no-stream

# With explicit X search results
grok-cli chat "Latest xAI updates" --with-x-search

# Pure chat without web search
grok-cli chat "Hello" --no-web-search

# JSON for scripts
grok-cli search --json --query "Grok updates"

grok-cli image "A cinematic skyline at sunrise"
grok-cli image-edit --image ./source.png --prompt "Make it cinematic"
grok-cli video "Animate a futuristic skyline" --duration 8
grok-cli video-edit --video-url https://example.com/source.mp4 --prompt "Make it cinematic"
grok-cli video-extend --video-url https://example.com/source.mp4 --prompt "Continue the camera move" --duration 6

grok-cli tts "Hello from Grok"
grok-cli stt ./sample.wav
grok-cli stt-stream ./sample.wav --interim-results

# View current model
grok-cli model

# Set a specific model for chat and search
grok-cli model --model grok-4.3

All commands accept --json for stable structured output. The envelope is consistent:

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

On failure:

{
  "ok": false,
  "command": "chat",
  "error": {
    "code": "auth_missing",
    "message": "...",
    "relogin_required": false,
    "entitlement_denied": false
  }
}

Designed for Codex, Claude Code, Cursor, and other agent runtimes. Install the bundled skill — it handles auth, command routing, and install checks automatically:

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

Use --help on any command for details.

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

Usage history tracks session totals, per-command events, media-type breakdowns, and rate-limit snapshots. Media files are not stored.

cargo test
cargo build --release
cargo install --path . --force

See CONTRIBUTING.md and SECURITY.md.

• Quickstart
• Command reference
• Troubleshooting
• Changelog