𝐗𝐀𝐈

Grok CLI Manual

Grok Hub

Install Grok CLI, connect it to XAI 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 XAI 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 XAI 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-06: the official xAI Grok Build documentation, Grok 4.5 and Grok Imagine model information, the local Grok CLI, and the XAI Router forwarding path.

1 What Is Grok CLI Understand Grok CLI modes, suitable tasks, and XAI 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 XAI Router Connect grok-4.5 Responses and Grok Imagine images and video with the main domain and your current XAI 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.