# Model Catalog

PromptScript ships a catalog of Anthropic, OpenAI, Google, and xAI models.
Agent `model` and `specModel` values and skill `model` values resolve against
it, so you write a model once and each target gets the name it expects. PS041
uses the same catalog to report deprecated and retired models, and it also
checks the `model.ref` of `@prompts` entries. Coding agent targets skip prompt
definitions, so none of them receives that name. The `bundle` target resolves the
reference and writes the profile, provider, and API id next to it.
`prs release status --check-models` checks the prompts of your release labels
against the same catalog.

This page is generated from the catalog source, so it matches what the
compiler does. To use a model that is not listed yet, or to change a built-in
profile, add it under `models.profiles` in `promptscript.yaml`. See
[Configuration: models](https://getpromptscript.dev/reference/config/index.md#models).

<!-- generated:start:catalog-summary -->
<!-- Auto-generated by `pnpm docs:models`. Do not edit manually. -->

This version ships 61 profiles from 4 providers. They were last checked against the provider documentation on 2026-10-18. Prices are list prices in USD per million tokens, read from the provider pricing page, or the OpenRouter listing when that page has none, on the date in the last column; they ignore cache, batch and long-context tiers.

<!-- generated:end:catalog-summary -->

## Model References

A value matches a profile by profile id, alias, API id, or display name,
ignoring case. `claude-opus-5-5`, `opus-5.5`, and `Claude Opus 5.5` all select
the same release. `inherit` keeps the model already selected in the tool.

Names that are not in the catalog are written unchanged on every target, so
gateway model ids, BYOK model ids, and Claude Code's `opusplan` keep working.
The exception is a value the target spells its own way: GitHub Copilot writes
`auto` as `Auto`.

## Floating Aliases

A floating alias points at the newest release of its Claude family that is
not retired. Claude Code and Grok Build write the alias as it is and pick the
release themselves. Other targets get the current release from this table, so
they move to a new release when you upgrade PromptScript and compile again.
Use a profile id when an agent must stay on one release.

A prompt writes its model as an object, `model: { ref: "claude-sonnet-5-5" }`,
and PS042 warns when `ref` is a floating alias. The warning becomes an error
when the prompt's `risk` is `high` or `critical`, so pin a release there.

<!-- generated:start:floating-aliases -->
<!-- Auto-generated by `pnpm docs:models`. Do not edit manually. -->

| Alias    | Family          | Current release     | Display name      |
| -------- | --------------- | ------------------- | ----------------- |
| `opus`   | `claude-opus`   | `claude-opus-5-5`   | Claude Opus 5.5   |
| `sonnet` | `claude-sonnet` | `claude-sonnet-5-5` | Claude Sonnet 5.5 |
| `haiku`  | `claude-haiku`  | `claude-haiku-5-5`  | Claude Haiku 5.5  |
| `fable`  | `claude-fable`  | `claude-fable-5-1`  | Claude Fable 5.1  |

<!-- generated:end:floating-aliases -->

## Target Model Names

Every target with a native model field has its own naming rule. This table
shows what each one writes for a few example values:

<!-- generated:start:target-names -->
<!-- Auto-generated by `pnpm docs:models`. Do not edit manually. -->

| Written in `.prs`        | Claude Code, Grok Build      | GitHub Copilot      | Factory AI                   | Codex            | Cursor                   |
| ------------------------ | ---------------------------- | ------------------- | ---------------------------- | ---------------- | ------------------------ |
| `opus`                   | `opus`                       | `Claude Opus 5.5`   | `claude-opus-5-5`            | omitted (PS4004) | `claude-opus-5-5`        |
| `sonnet`                 | `sonnet`                     | `Claude Sonnet 5.5` | `claude-sonnet-5-5`          | omitted (PS4004) | `claude-sonnet-5-5`      |
| `haiku`                  | `haiku`                      | `Claude Haiku 5.5`  | `claude-haiku-5-5`           | omitted (PS4004) | `claude-haiku-5-5`       |
| `fable`                  | `fable`                      | `Claude Fable 5.1`  | `claude-fable-5-1`           | omitted (PS4004) | `claude-fable-5-1`       |
| `inherit`                | `inherit`                    | omitted             | `inherit`                    | omitted          | `inherit`                |
| `claude-sonnet-4-5`      | `claude-sonnet-4-5-20250929` | `Claude Sonnet 4.5` | `claude-sonnet-4-5-20250929` | omitted (PS4004) | `claude-sonnet-4-5`      |
| `gpt-5.3-codex`          | omitted (PS4004)             | `GPT-5.3-Codex`     | `gpt-5.3-codex`              | `gpt-5.3-codex`  | `gpt-5.3-codex`          |
| `gemini-3.1-pro-preview` | omitted (PS4004)             | `Gemini 3.1 Pro`    | `gemini-3.1-pro-preview`     | omitted (PS4004) | `gemini-3.1-pro-preview` |

<!-- generated:end:target-names -->

- `omitted` means the output has no model field, so the tool uses its default
  model.
- `omitted (PS4004)` means the target cannot run models from this provider.
  Compilation reports a PS4004 warning. To write a name anyway, set
  `models.profiles.<id>.targets.<target>` in `promptscript.yaml`.

GitHub Copilot and Factory AI map `specModel` the same way. Claude Code and
Grok Build also map the `model` field of skills, including a model written in
the skill file's own frontmatter; a `model` set in `.prs` wins. The rules
behind the table are listed in
[Configuration: target model names](https://getpromptscript.dev/reference/config/index.md#target-model-names).

## Profiles

| Status       | Meaning                                                      |
| ------------ | ------------------------------------------------------------ |
| `current`    | Recommended for new instructions                             |
| `legacy`     | Still served, but a newer release replaces it                |
| `deprecated` | The provider announced it will retire the model; PS041 warns |
| `retired`    | The provider no longer serves the model; PS041 warns         |

PS041 suggests a replacement by following the successor chain to a current
release. Dates follow the provider API. A tool can stop offering a model
before the provider retires it.

<!-- generated:start:profiles -->
<!-- Auto-generated by `pnpm docs:models`. Do not edit manually. -->

### Anthropic

| Profile id          | Display name      | API id                       | Aliases                                  | Status                         | Released   | Successor           | Input $/MTok | Output $/MTok | Price checked |
| ------------------- | ----------------- | ---------------------------- | ---------------------------------------- | ------------------------------ | ---------- | ------------------- | ------------ | ------------- | ------------- |
| `claude-opus-4`     | Claude Opus 4     | `claude-opus-4-20250514`     | `opus-4`                                 | retired on 2026-06-15          | 2025-05-22 | `claude-opus-4-1`   | 15           | 75            | 2026-10-22    |
| `claude-opus-4-1`   | Claude Opus 4.1   | `claude-opus-4-1-20250805`   | `opus-4.1`                               | retired on 2026-08-05          | 2025-08-05 | `claude-opus-4-5`   | 15           | 75            | 2026-10-22    |
| `claude-opus-4-5`   | Claude Opus 4.5   | `claude-opus-4-5-20251101`   | `opus-4.5`                               | legacy                         | 2025-11-24 | `claude-opus-4-6`   | 5            | 25            | 2026-10-22    |
| `claude-opus-4-6`   | Claude Opus 4.6   | `claude-opus-4-6`            | `opus-4.6`                               | legacy                         | -          | `claude-opus-4-7`   | 5            | 25            | 2026-10-22    |
| `claude-opus-4-7`   | Claude Opus 4.7   | `claude-opus-4-7`            | `opus-4.7`                               | legacy                         | -          | `claude-opus-4-8`   | 5            | 25            | 2026-10-22    |
| `claude-opus-4-8`   | Claude Opus 4.8   | `claude-opus-4-8`            | `opus-4.8`                               | legacy                         | -          | `claude-opus-5`     | 5            | 25            | 2026-10-22    |
| `claude-opus-5`     | Claude Opus 5     | `claude-opus-5`              | `opus-5`                                 | legacy                         | 2026-07-24 | `claude-opus-5-5`   | 5            | 25            | 2026-10-22    |
| `claude-opus-5-5`   | Claude Opus 5.5   | `claude-opus-5-5`            | `opus-5.5`                               | current                        | 2026-09-22 | -                   | 4            | 20            | 2026-10-22    |
| `claude-3-5-sonnet` | Claude 3.5 Sonnet | `claude-3-5-sonnet-20241022` | `sonnet-3.5`, `claude-3-5-sonnet-latest` | retired on 2025-10-28          | 2024-10-22 | `claude-3-7-sonnet` | -            | -             | -             |
| `claude-3-7-sonnet` | Claude 3.7 Sonnet | `claude-3-7-sonnet-20250219` | `sonnet-3.7`, `claude-3-7-sonnet-latest` | retired on 2026-02-19          | 2025-02-24 | `claude-sonnet-4`   | -            | -             | -             |
| `claude-sonnet-4`   | Claude Sonnet 4   | `claude-sonnet-4-20250514`   | `sonnet-4`                               | retired on 2026-06-15          | 2025-05-22 | `claude-sonnet-4-5` | 3            | 15            | 2026-10-22    |
| `claude-sonnet-4-5` | Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929` | `sonnet-4.5`                             | deprecated, retires 2026-11-30 | 2025-09-29 | `claude-sonnet-4-6` | 3            | 15            | 2026-10-22    |
| `claude-sonnet-4-6` | Claude Sonnet 4.6 | `claude-sonnet-4-6`          | `sonnet-4.6`                             | legacy                         | -          | `claude-sonnet-5`   | 3            | 15            | 2026-10-22    |
| `claude-sonnet-5`   | Claude Sonnet 5   | `claude-sonnet-5`            | `sonnet-5`                               | legacy                         | 2026-06-30 | `claude-sonnet-5-5` | 2            | 10            | 2026-10-22    |
| `claude-sonnet-5-5` | Claude Sonnet 5.5 | `claude-sonnet-5-5`          | `sonnet-5.5`                             | current                        | 2026-09-28 | -                   | 2            | 10            | 2026-10-22    |
| `claude-3-5-haiku`  | Claude 3.5 Haiku  | `claude-3-5-haiku-20241022`  | `haiku-3.5`, `claude-3-5-haiku-latest`   | retired on 2026-02-19          | 2024-10-22 | `claude-haiku-4-5`  | 0.8          | 4             | 2026-10-22    |
| `claude-haiku-4-5`  | Claude Haiku 4.5  | `claude-haiku-4-5-20251001`  | `haiku-4.5`                              | legacy                         | 2025-10-15 | `claude-haiku-5-5`  | 1            | 5             | 2026-10-22    |
| `claude-haiku-5-5`  | Claude Haiku 5.5  | `claude-haiku-5-5`           | `haiku-5.5`                              | current                        | 2026-10-07 | -                   | 0.1          | 0.5           | 2026-10-22    |
| `claude-fable-5`    | Claude Fable 5    | `claude-fable-5`             | `fable-5`                                | legacy                         | 2026-06-09 | `claude-fable-5-1`  | 10           | 50            | 2026-10-22    |
| `claude-fable-5-1`  | Claude Fable 5.1  | `claude-fable-5-1`           | `fable-5.1`                              | current                        | 2026-09-01 | -                   | 10           | 50            | 2026-10-22    |
| `claude-mythos-5`   | Claude Mythos 5   | `claude-mythos-5`            | `mythos-5`                               | legacy                         | 2026-06-09 | `claude-mythos-5-1` | 10           | 50            | 2026-10-22    |
| `claude-mythos-5-1` | Claude Mythos 5.1 | `claude-mythos-5-1`          | `mythos-5.1`                             | current                        | 2026-09-01 | -                   | 10           | 50            | 2026-10-22    |

### OpenAI

| Profile id           | Display name       | API id               | Aliases | Status                         | Released   | Successor       | Input $/MTok | Output $/MTok | Price checked |
| -------------------- | ------------------ | -------------------- | ------- | ------------------------------ | ---------- | --------------- | ------------ | ------------- | ------------- |
| `gpt-4o`             | GPT-4o             | `gpt-4o`             | -       | legacy                         | 2024-05-13 | `gpt-4.1`       | 2.5          | 10            | 2026-10-22    |
| `gpt-4.1`            | GPT-4.1            | `gpt-4.1`            | -       | legacy                         | 2025-04-14 | `gpt-5.5`       | 2            | 8             | 2026-10-22    |
| `gpt-5`              | GPT-5              | `gpt-5`              | -       | deprecated, retires 2026-12-11 | 2025-08-07 | `gpt-5.1`       | 1.25         | 10            | 2026-10-22    |
| `gpt-5.1`            | GPT-5.1            | `gpt-5.1`            | -       | deprecated                     | 2025-11-13 | `gpt-5.2`       | 1.25         | 10            | 2026-10-22    |
| `gpt-5.2`            | GPT-5.2            | `gpt-5.2`            | -       | legacy                         | 2025-12-11 | `gpt-5.4`       | 1.75         | 14            | 2026-10-22    |
| `gpt-5.4`            | GPT-5.4            | `gpt-5.4`            | -       | legacy                         | 2026-03-05 | `gpt-5.5`       | 2.5          | 15            | 2026-10-22    |
| `gpt-5.5`            | GPT-5.5            | `gpt-5.5`            | -       | legacy                         | 2026-04-24 | `gpt-5.6-sol`   | 5            | 30            | 2026-10-22    |
| `gpt-5-mini`         | GPT-5 mini         | `gpt-5-mini`         | -       | deprecated, retires 2026-12-11 | 2025-08-07 | `gpt-5.4-mini`  | 0.25         | 2             | 2026-10-22    |
| `gpt-5.4-mini`       | GPT-5.4 mini       | `gpt-5.4-mini`       | -       | legacy                         | 2026-03-17 | `gpt-5.6-terra` | 0.75         | 4.5           | 2026-10-22    |
| `gpt-5-nano`         | GPT-5 nano         | `gpt-5-nano`         | -       | deprecated, retires 2026-12-11 | 2025-08-07 | `gpt-5.4-nano`  | 0.05         | 0.4           | 2026-10-22    |
| `gpt-5.4-nano`       | GPT-5.4 nano       | `gpt-5.4-nano`       | -       | legacy                         | 2026-03-17 | `gpt-5.6-luna`  | 0.2          | 1.25          | 2026-10-22    |
| `gpt-5-codex`        | GPT-5-Codex        | `gpt-5-codex`        | -       | legacy                         | -          | `gpt-5.1-codex` | -            | -             | -             |
| `gpt-5.1-codex`      | GPT-5.1-Codex      | `gpt-5.1-codex`      | -       | legacy                         | 2025-11-13 | `gpt-5.2-codex` | 1.25         | 10            | 2026-10-26    |
| `gpt-5.2-codex`      | GPT-5.2-Codex      | `gpt-5.2-codex`      | -       | deprecated                     | 2026-01-14 | `gpt-5.3-codex` | 1.75         | 14            | 2026-10-26    |
| `gpt-5.3-codex`      | GPT-5.3-Codex      | `gpt-5.3-codex`      | -       | current                        | 2026-02-24 | -               | 1.75         | 14            | 2026-10-22    |
| `gpt-5.1-codex-max`  | GPT-5.1-Codex-Max  | `gpt-5.1-codex-max`  | -       | legacy                         | 2025-12-04 | `gpt-5.2-codex` | 1.25         | 10            | 2026-10-26    |
| `gpt-5.1-codex-mini` | GPT-5.1-Codex-Mini | `gpt-5.1-codex-mini` | -       | legacy                         | 2025-11-13 | `gpt-5.3-codex` | 0.25         | 2             | 2026-10-26    |
| `gpt-5.6-sol`        | GPT-5.6 Sol        | `gpt-5.6-sol`        | -       | legacy                         | 2026-07-09 | `gpt-6-astra`   | 4            | 20            | 2026-10-22    |
| `gpt-6-sol`          | GPT-6 Sol          | `gpt-6-sol`          | -       | legacy                         | 2026-09-22 | `gpt-6.1-sol`   | 2            | 10            | 2026-10-22    |
| `gpt-6.1-sol`        | GPT-6.1 Sol        | `gpt-6.1-sol`        | -       | current                        | 2026-09-29 | -               | 2            | 10            | 2026-10-22    |
| `gpt-5.6-terra`      | GPT-5.6 Terra      | `gpt-5.6-terra`      | -       | legacy                         | 2026-07-09 | `gpt-6-sol`     | 2            | 12            | 2026-10-22    |
| `gpt-5.6-luna`       | GPT-5.6 Luna       | `gpt-5.6-luna`       | -       | legacy                         | 2026-07-09 | `gpt-6-luna`    | 0.2          | 1.2           | 2026-10-22    |
| `gpt-6-luna`         | GPT-6 Luna         | `gpt-6-luna`         | -       | current                        | 2026-09-22 | -               | 0.1          | 0.5           | 2026-10-22    |
| `gpt-6-astra`        | GPT-6 Astra        | `gpt-6-astra`        | -       | current                        | 2026-09-03 | -               | 10           | 50            | 2026-10-22    |
| `o3`                 | o3                 | `o3`                 | -       | deprecated, retires 2026-12-11 | 2025-04-16 | `gpt-5.5`       | 2            | 8             | 2026-10-22    |
| `o4-mini`            | o4-mini            | `o4-mini`            | -       | deprecated, retires 2026-10-23 | 2025-04-16 | `gpt-5.4-mini`  | 1.1          | 4.4           | 2026-10-22    |

### Google

| Profile id               | Display name          | API id                   | Aliases                  | Status                         | Released   | Successor                | Input $/MTok | Output $/MTok | Price checked |
| ------------------------ | --------------------- | ------------------------ | ------------------------ | ------------------------------ | ---------- | ------------------------ | ------------ | ------------- | ------------- |
| `gemini-2.5-pro`         | Gemini 2.5 Pro        | `gemini-2.5-pro`         | -                        | legacy                         | 2025-06-17 | `gemini-3.1-pro-preview` | -            | -             | -             |
| `gemini-3.1-pro-preview` | Gemini 3.1 Pro        | `gemini-3.1-pro-preview` | `Gemini 3.1 Pro Preview` | current                        | 2026-02-19 | -                        | -            | -             | -             |
| `gemini-2.5-flash`       | Gemini 2.5 Flash      | `gemini-2.5-flash`       | -                        | legacy                         | 2025-06-17 | `gemini-3.5-flash`       | -            | -             | -             |
| `gemini-3.5-flash`       | Gemini 3.5 Flash      | `gemini-3.5-flash`       | -                        | legacy                         | 2026-05-19 | `gemini-3.6-flash`       | -            | -             | -             |
| `gemini-3.6-flash`       | Gemini 3.6 Flash      | `gemini-3.6-flash`       | -                        | legacy                         | 2026-07-21 | `gemini-3.7-flash`       | -            | -             | -             |
| `gemini-3.7-flash`       | Gemini 3.7 Flash      | `gemini-3.7-flash`       | -                        | legacy                         | 2026-08-13 | `gemini-3.8-flash`       | -            | -             | -             |
| `gemini-3.8-flash`       | Gemini 3.8 Flash      | `gemini-3.8-flash`       | -                        | current                        | 2026-09-02 | -                        | -            | -             | -             |
| `gemini-2.5-flash-lite`  | Gemini 2.5 Flash-Lite | `gemini-2.5-flash-lite`  | -                        | legacy                         | 2025-07-22 | `gemini-3.1-flash-lite`  | -            | -             | -             |
| `gemini-3.1-flash-lite`  | Gemini 3.1 Flash-Lite | `gemini-3.1-flash-lite`  | -                        | deprecated, retires 2027-05-07 | 2026-05-07 | `gemini-3.5-flash-lite`  | -            | -             | -             |
| `gemini-3.5-flash-lite`  | Gemini 3.5 Flash-Lite | `gemini-3.5-flash-lite`  | -                        | current                        | 2026-07-21 | -                        | -            | -             | -             |

### xAI

| Profile id | Display name | API id     | Aliases | Status  | Released | Successor  | Input $/MTok | Output $/MTok | Price checked |
| ---------- | ------------ | ---------- | ------- | ------- | -------- | ---------- | ------------ | ------------- | ------------- |
| `grok-4.5` | Grok 4.5     | `grok-4.5` | -       | legacy  | -        | `grok-4.6` | -            | -             | -             |
| `grok-4.6` | Grok 4.6     | `grok-4.6` | -       | legacy  | -        | `grok-4.7` | -            | -             | -             |
| `grok-4.7` | Grok 4.7     | `grok-4.7` | -       | current | -        | -          | -            | -             | -             |

<!-- generated:end:profiles -->