> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/warpdotdev/warp/llms.txt
> Use this file to discover all available pages before exploring further.

# oz model — list available AI models

> Use oz model list to see the AI models available to your Warp account, then pass a model ID to --model when running agents or schedules.

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

```bash theme={null}
oz model <subcommand> [flags]
```

## Subcommands

| Subcommand | Description                  |
| ---------- | ---------------------------- |
| `list`     | List all available AI models |

***

## oz model list

Lists the AI models available to your account.

```bash theme={null}
oz model list
```

### Examples

```bash theme={null}
# 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:

```bash theme={null}
# 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
```

<Tip>
  If you do not specify `--model`, the agent uses the default model configured for your account.
</Tip>