video

Generate a video from a text prompt.

Raw slash-command arguments: $ARGUMENTS

How it works:

Grok CLI 1.0 has no text-to-video tool. Its media toolset is image_gen, image_edit, image_to_video, and reference_to_video. So this command runs two steps: it generates an opening frame with image_gen, then animates that frame with image_to_video. Both artefacts are saved — the still is the clip's first frame, and it is worth keeping.

Argument handling:

• Pass the prompt through verbatim.
• --aspect applies to both steps. --duration is in seconds.
• If the user already has a still they want animated, use /grok:animate instead — it skips the generation step and animates their exact image.

Execution — this takes a few minutes, so prefer the background unless the user asked to wait:

Bash({
  command: `node "${CLAUDE_PLUGIN_ROOT}/scripts/grok-companion.mjs" video $ARGUMENTS`,
  description: "Grok video generation",
  run_in_background: true
})

Foreground, when the user passed --wait or explicitly asked to wait:

node "${CLAUDE_PLUGIN_ROOT}/scripts/grok-companion.mjs" video $ARGUMENTS

Output rules:

• Relay the companion's output verbatim.
• You cannot view a video. Report the path and the file size; do not describe the motion or claim the clip looks right.
• If the run reports that xAI rejected the request under Zero Data Retention, relay that explanation as-is. It is an account setting, not a bug in the prompt, and retrying will fail identically — say so instead of trying again.
• A run that produced only the still frame is reported as incomplete. Do not present it as a finished video.