Model Aliases

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

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.

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-4-5-`, `anthropic/sonnet-4-5-`, `copilot/sonnet-4-6`, `anthropic/sonnet-4-6`
`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.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-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`
`mai-code`	`copilot/MAI-Code`, `copilot/mai-code`, `openai/MAI-Code*`
`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-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`, `gemini/gemini-image`, `copilot/gemini-flash`, `gemini/gemini-flash`
`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*`
`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`
`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`

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-5-pro` → `gpt-5` → `gemini-pro`
`agent`	`sonnet-6x` → `gpt-5.4` → `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`