Skip to main content
The oz model command lists the AI models available to your Warp account. Use the model IDs returned here with the --model flag when running agents (oz agent run, oz agent run-cloud) or creating/updating scheduled agents (oz schedule create, oz schedule update).

Synopsis

oz model <subcommand> [flags]

Subcommands

SubcommandDescription
listList all available AI models

oz model list

Lists the AI models available to your account.
oz model list

Examples

# List available models in human-readable format
oz model list

# Machine-readable JSON output
oz model list --output-format json

Using model IDs

Pass a model ID from oz model list to the --model flag on any command that accepts it:
# Run a local agent with a specific model
oz agent run --prompt "Refactor the auth module" --model claude-opus-4

# Dispatch a cloud agent with a specific model
oz agent run-cloud \
  --prompt "Investigate slow API endpoints" \
  --model claude-opus-4 \
  --environment env_abc123

# Create a scheduled agent pinned to a model
oz schedule create \
  --name "nightly-review" \
  --cron "0 2 * * *" \
  --prompt "Review merged PRs and post a summary" \
  --model claude-opus-4 \
  --environment env_abc123
If you do not specify --model, the agent uses the default model configured for your account.

Build docs developers (and LLMs) love