ReferenceCLI
vx models
List the model and effort profiles a dispatch can use
List the model and effort profiles a dispatch can use. Read-only.
Usage:
vx models
Prints the merged profile table: the built-in defaults, overridden by the
optional global ~/.vexillum/models.json, overridden by this project's
.vexillum/models.json. Each profile shows its model and effort (and its
harness, when it sets one) and a "when" line saying when it applies; the table's default entry and the files
that were read are listed at the end. Pass a profile to
'vx dispatch --profile <name>'.
This is a lookup table, not a router: which profile fits a task is the
commander's judgment, made from the "when" lines. A models file that is
not valid JSON, names a model or effort its harness does not accept (claude:
haiku, sonnet, opus, fable and low to max; pi: a provider/id model such as
anthropic/claude-sonnet-5 and a thinking level off to max; opencode: a
provider/model with an optional #variant, and any plain label as the effort),
or names an unknown harness is an error naming the file and field.