Skip to content

halo model switch

Point an alias at a model: in place, or with –canary as a guardrailed traffic rollout

<model> is a provider model id, optionally prefixed <provider>/ (e.g. bedrock/anthropic.claude-opus-5-5). Without –canary the route is edited in place (halos.yaml models.<alias> in simple mode). With –canary it writes a traffic-axis Rollout from the rollout preset plus its experiment.

Terminal window
halo model switch <alias> <model> [flags]
Flag Shorthand Type Default Description
--canary bool false roll out as a guardrailed canary instead of switching at once
--dry-run bool false print the diff instead of writing
--policy-dir string policy repo directory (default “.”)
Flag Shorthand Type Default Description
--output string text output format: text|json

halo model