𝐙𝐀𝐈

Grok CLI Manual

Grok Hub

Install Grok CLI, connect it to ZAI Router, then learn Grok Imagine image and video generation, permissions, sessions, worktrees, and API usage step by step.

Grok by xAI

This practical manual covers Grok CLI and Grok API access through ZAI Router. Complete installation and configuration first, then try image generation, editing, video generation, and one small, verifiable task.

Recommended path:

  1. Understand what Grok CLI can do and where it runs.
  2. Install the CLI and check the current version.
  3. Configure ~/.grok/config.toml and ZAI Router.
  4. Generate and edit images with /imagine, image tools, or the Images API.
  5. Generate, poll, and save videos with /imagine-video or the Videos API.
  6. Complete one verifiable task in a real project.
  7. Move on to session resume, worktrees, structured output, and MCP.

Sources checked on 2026-08-16: the official xAI Grok Build documentation, Grok 4.6 and Grok Imagine model information, the local Grok CLI, and the ZAI Router forwarding path.

1 What Is Grok CLI Understand Grok CLI modes, suitable tasks, and ZAI Router paths for model, image, and video requests. 2 Download and Install Install, update, and verify Grok CLI. 3 Your First Task Open a real project and complete one small, verifiable Grok task. 4 Configuration Understand config.toml paths, models, endpoints, sessions, and UI settings. 5 Use ZAI Router Connect grok-4.6 Responses and Grok Imagine images and video with the main domain and your current ZAI API Key. 6 Image Generation and Editing Configure Grok CLI's image endpoint and generate or edit images with /imagine, image_gen, image_edit, and the Images API. 7 Video Generation Generate, poll, and save Grok Imagine videos with /imagine-video, image_to_video, reference_to_video, and the Videos API. 8 Permissions and Safety Understand auto-approval, plan mode, allow/deny rules, and sandboxing. 9 Workflows and Troubleshooting Sessions, worktrees, self-checking, structured output, MCP, and common failures.