Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: Query the Workers AI model catalog with Wrangler
description: Wrangler can now query the Workers AI model catalog from the command line.
products:
- workers-ai
date: 2026-05-12
---

`wrangler ai models list` is now available for querying the Workers AI model catalog from the command line.

Use `--search`, `--task`, `--author`, `--source`, and `--hide-experimental` to narrow model results:
Comment thread
bghira marked this conversation as resolved.

```sh
wrangler ai models list --search llama --task "Text Generation" --hide-experimental
```

You can also combine filters with `--json` for structured output:

```sh
wrangler ai models list --author cloudflare --source 1 --json
```

For full usage details, refer to the [Workers AI Wrangler commands documentation](/workers-ai/wrangler-commands/).
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: Fetch Workers AI model schemas with Wrangler
description: Wrangler can now fetch Workers AI model input and output schemas from the command line.
products:
- workers-ai
date: 2026-05-13
---

`wrangler ai models schema <model>` is now available for fetching a Workers AI model's input and output schema from the command line.

```sh
wrangler ai models schema "@cf/meta/llama-3.3-70b-instruct-fp8-fast"
```

The command returns JSON that describes the model request and response fields.

For full usage details, refer to the [Workers AI Wrangler commands documentation](/workers-ai/wrangler-commands/).
60 changes: 60 additions & 0 deletions src/content/docs/workers-ai/wrangler-commands.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
pcx_content_type: reference
title: Wrangler commands
description: Query the Workers AI model catalog and inspect model schemas from the command line using Wrangler.
sidebar:
order: 3
products:
- workers-ai
---

Use `wrangler ai models list` to query the Workers AI model catalog from your terminal. The command lists matching models in a table by default.

Before you run this command, authenticate Wrangler with an account that has the `Workers AI Read` permission.

```sh
npx wrangler ai models list
```

To return the response as JSON, add `--json`:

```sh
npx wrangler ai models list --json
```

## Query the model catalog

Use filters to narrow model results by keyword, task, author, source, or release status:

```sh
npx wrangler ai models list --search llama --task "Text Generation" --hide-experimental
```

```sh
npx wrangler ai models list --author cloudflare --source 1 --json
```

The `wrangler ai models list` command supports the following options:

| Option | Description |
| --------------------- | ---------------------------- |
| `--search <query>` | Search models by keyword. |
| `--task <task>` | Filter by task name. |
| `--author <author>` | Filter by author. |
| `--source <id>` | Filter by source ID. |
| `--hide-experimental` | Hide experimental models. |
| `--json` | Return the response as JSON. |

For the underlying API, refer to [Model Search](/api/resources/ai/subresources/models/methods/list/).

## Fetch a model schema

Use `wrangler ai models schema` to fetch a model's input and output schema:

```sh
npx wrangler ai models schema "@cf/meta/llama-3.3-70b-instruct-fp8-fast"
```

The command returns JSON that describes the model request and response fields.

For the underlying API, refer to [Get Model Schema](/api/resources/ai/subresources/models/subresources/schema/methods/get/).