Model Aliases

This page lists the built-in model aliases used by GitHub Agentic Workflows.

Copilot catalogs can differ by organization and lag Copilot seats; an exact ID missing from a complete live catalog is not offered to this workflow, so prefer opus or sonnet aliases. Run gh aw audit <run-url> --models for detailed model information from that run; see workflow-specific catalog availability.

Model Aliases

Model aliases let you write engine: copilot with a human-friendly model name such as sonnet or mini, and gh-aw resolves it to the best available concrete model at compile time. Each alias holds an ordered list of patterns; the first pattern that matches an available model wins.

For details on the alias syntax, fallback resolution algorithm, and how to define your own aliases in workflow frontmatter, see the Model Alias Format Specification.

router and router/* are reserved and are not aliases. model: router, router/economy, router/balanced, and router/robust choose model routing for the main agent; they can’t be defined in models: or used in models.allowed, models.blocked, or fallback-models.

Vendor Aliases

Vendor aliases map a short name to one or more provider-scoped glob patterns. The Copilot gateway is always tried first.

Alias	Fallback patterns (tried in order)
`sonnet`	`copilot/sonnet`, `anthropic/sonnet`
`sonnet-6x`	`copilot/sonnet-4.5`, `copilot/sonnet-4.6`, `copilot/sonnet-5`, `copilot/sonnet-4-5-`, `anthropic/sonnet-4-5-`, `copilot/sonnet-4-6`, `anthropic/sonnet-4-6`, `anthropic/sonnet-5`
`haiku`	`copilot/haiku`, `anthropic/haiku`
`opus`	`copilot/opus`, `anthropic/opus`
`gpt-5`	`copilot/gpt-5`, `openai/gpt-5`
`gpt-5.5`	`copilot/gpt-5.5`, `openai/gpt-5.5`
`gpt-5.6`	`copilot/gpt-5.6`, `openai/gpt-5.6`
`gpt-6`	`copilot/gpt-6`, `openai/gpt-6`
`gpt-5.4`	`copilot/gpt-5.4`, `openai/gpt-5.4`
`gpt-5.3`	`copilot/gpt-5.3`, `openai/gpt-5.3`
`gpt-5.2`	`copilot/gpt-5.2`, `openai/gpt-5.2`
`gpt-5.1`	`copilot/gpt-5.1`, `openai/gpt-5.1`
`gpt-5-mini`	`copilot/gpt-5mini`, `openai/gpt-5mini`
`gpt-5-nano`	`copilot/gpt-5nano`, `openai/gpt-5nano`
`gpt-5-codex`	`copilot/gpt-5codex`, `openai/gpt-5codex`
`coding`	`copilot/gpt-5codex`, `openai/gpt-5codex`, `gpt-5-codex`, `kimi`
`mai-code`	`copilot/MAI-Code`, `copilot/mai-code`, `openai/MAI-Code*`
`kimi`	`copilot/kimi`, `openai/kimi`
`kiwi`	`copilot/kiwi`, `openai/kiwi`
`raptor-mini`	`copilot/raptor`, `openai/raptor`
`gpt-5-pro`	`copilot/gpt-5pro`, `openai/gpt-5pro`
`reasoning`	`copilot/o1`, `copilot/o3`, `copilot/o4`, `openai/o1`, `openai/o3`, `openai/o4`
`gemini-flash`	`copilot/gemini-flash`, `google/gemini-flash`, `gemini/gemini-flash`
`gemini-omni`	`copilot/gemini-omni`, `google/gemini-omni`, `gemini/gemini-omni*`
`gemini-flash-lite`	`copilot/gemini-flashlite`, `google/gemini-flashlite`, `gemini/gemini-flashlite*`
`gemini-pro`	`copilot/gemini-pro`, `google/gemini-pro`, `gemini/gemini-pro`
`vision`	`copilot/gemini-image`, `google/gemini-image`, `gemini/gemini-image`, `copilot/gemini-flash`, `google/gemini-flash`, `gemini/gemini-flash`
`image-generation`	`copilot/gpt-image`, `openai/gpt-image`, `openai/chatgpt-image`, `copilot/gemini-image`, `google/gemini-image`, `gemini/gemini-image`, `google/imagen`
`gemma`	`copilot/gemma`, `google/gemma`, `gemini/gemma*`
`deep-research`	`copilot/deep-research`, `copilot/o3-deep-research`, `copilot/o4-mini-deep-research`, `google/deep-research`, `gemini/deep-research`, `openai/o3-deep-research`, `openai/o4-mini-deep-research*`
`detection`	`small`, `copilot/gpt--luna`, `openai/gpt--luna`, `small-agent`, `agent`
`evals`	`copilot/gpt-6-luna-decisions`
`fable`	`copilot/fable`, `anthropic/fable`
`auto`	`copilot/auto`, `large`
`any`	`copilot/`, `anthropic/`, `openai/`, `google/`, `gemini/*`
`gemini-3-pro`	`copilot/gemini-3pro`, `google/gemini-3pro`, `google/nano-banana`, `gemini/gemini-3pro*`
`gemini-3-flash`	`copilot/gemini-3flash`, `google/gemini-3flash`, `gemini/gemini-3flash`
`gemini-3.1-pro`	`copilot/gemini-3.1pro`, `google/gemini-3.1pro`, `gemini/gemini-3.1pro`
`gemini-3.1-flash`	`copilot/gemini-3.1flash`, `google/gemini-3.1flash`, `gemini/gemini-3.1flash`
`gemini-3.5-flash`	`copilot/gemini-3.5flash`, `google/gemini-3.5flash`, `gemini/gemini-3.5flash`
`gemini-3.6-flash`	`copilot/gemini-3.6flash`, `google/gemini-3.6flash`, `gemini/gemini-3.6flash`
`gemini-3.7-flash`	`copilot/gemini-3.7flash`, `google/gemini-3.7flash`, `gemini/gemini-3.7flash`
`gemini-3.8-flash`	`copilot/gemini-3.8flash`, `google/gemini-3.8flash`, `gemini/gemini-3.8flash`
`antigravity`	`copilot/antigravity`, `google/antigravity`, `gemini/antigravity*`
`nano-banana`	`copilot/nano-banana`, `google/nano-banana`, `gemini/nano-banana*`
`computer-use`	`copilot/computer-use`, `google/computer-use`, `gemini/computer-use`, `openai/computer-use`
`robotics`	`copilot/robotics`, `google/robotics`, `gemini/robotics`
`veo`	`google/veo`, `gemini/veo`
`lyria`	`google/lyria`, `gemini/lyria`, `copilot/lyria*`
`grok`	`copilot/grok`, `openai/grok`

Meta-Aliases

Meta-aliases reference other aliases by name. They are resolved recursively until a concrete pattern is reached.

Meta-alias	Expands to
`opusplan`	`opus?effort=high`
`small`	`mini`
`mini`	`haiku` → `gpt-5-mini` → `gpt-5-nano` → `gemini-flash-lite`
`large`	`sonnet` → `gpt-6` → `gpt-5-pro` → `gpt-5` → `gemini-pro`
`agent`	`sonnet-6x` → `gpt-6` → `gpt-5.4` → `gpt-5.5` → `gpt-5.6` → `gpt-5.3` → `gemini-pro` → `any`
`small-agent`	`haiku` → `gpt-5-mini` → `gemini-flash`
`copilot`	`agent`
`claude`	`agent`
`codex`	`agent`
`gemini`	`agent`
`summarization`	`haiku` → `gpt-5-mini` → `gemini-flash-lite` → `mini`