Model Aliases | GitHub Agentic Workflows
Skip to main content 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 Section titled “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 Section titled “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-5*mini* , openai/gpt-5*mini* gpt-5-nano copilot/gpt-5*nano* , openai/gpt-5*nano* gpt-5-codex copilot/gpt-5*codex* , openai/gpt-5*codex* coding copilot/gpt-5*codex* , openai/gpt-5*codex* , 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-5*pro* , openai/gpt-5*pro* 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-*flash*lite* , google/gemini-*flash*lite* , gemini/gemini-*flash*lite* 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-3*pro* , google/gemini-3*pro* , google/nano-banana* , gemini/gemini-3*pro* gemini-3-flash copilot/gemini-3*flash* , google/gemini-3*flash* , gemini/gemini-3*flash* gemini-3.1-pro copilot/gemini-3.1*pro* , google/gemini-3.1*pro* , gemini/gemini-3.1*pro* gemini-3.1-flash copilot/gemini-3.1*flash* , google/gemini-3.1*flash* , gemini/gemini-3.1*flash* gemini-3.5-flash copilot/gemini-3.5*flash* , google/gemini-3.5*flash* , gemini/gemini-3.5*flash* gemini-3.6-flash copilot/gemini-3.6*flash* , google/gemini-3.6*flash* , gemini/gemini-3.6*flash* gemini-3.7-flash copilot/gemini-3.7*flash* , google/gemini-3.7*flash* , gemini/gemini-3.7*flash* gemini-3.8-flash copilot/gemini-3.8*flash* , google/gemini-3.8*flash* , gemini/gemini-3.8*flash* 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 Section titled “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