Skip to main content

​
fased models

Use fased models to inspect model discovery, auth state, aliases, and the resolved default or fallback chain. Browser equivalent: Agent > Models. Provider sign-in makes models available; each Agent chooses its own primary, fallback, and task-role model refs. Related:

​
Common commands

fased models status
fased models list
fased models set <model-or-alias>
fased models set-image <model-or-alias>
fased models scan
fased models status shows the resolved default/fallbacks plus an auth overview. When provider usage snapshots are available, the OAuth/token status section includes provider usage headers. Add --probe to run live auth probes against each configured provider profile. Probes are real requests (may consume tokens and trigger rate limits). Use --agent <id> to inspect a configured agent’s model/auth state. When omitted, the command uses FASED_AGENT_DIR/PI_CODING_AGENT_DIR if set, otherwise the configured default agent. Notes:
  • models set <model-or-alias> accepts provider/model or an alias.
  • Model refs are parsed by splitting on the first /. If the model ID includes / (OpenRouter-style), include the provider prefix (example: openrouter/moonshotai/kimi-k2).
  • If you omit the provider, Fased treats the input as an alias or a model for the default provider (only works when there is no / in the model ID).

​
Catalog source order

fased models list --all, onboarding model selection, and provider-filtered fallback lists use the same Fased catalog merge order:
  1. models.providers in your config wins for matching provider/model ids.
  2. Runtime-discovered models from the local agent catalog fill in installed provider data.
  3. Fased’s bundled current-model overlay fills in new model names when the runtime catalog is stale.
Provider aliases such as z.ai and z-ai normalize to the same provider key.

​
models status

Options:
  • --json
  • --plain
  • --check (exit 1=expired/missing, 2=expiring)
  • --probe (live probe of configured auth profiles)
  • --probe-provider <name> (probe one provider)
  • --probe-profile <id> (repeat or comma-separated profile ids)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>
  • --agent <id> (configured agent id; overrides FASED_AGENT_DIR/PI_CODING_AGENT_DIR)

​
models list

Options:
  • --all: show the merged full catalog.
  • --local: filter to local models.
  • --provider <name>: filter by provider.
  • --json
  • --plain

​
Aliases + fallbacks

fased models aliases list
fased models fallbacks list
fased models image-fallbacks list
Fallback groups support list, add <model>, remove <model>, and clear. image-fallbacks controls the image-model fallback list separately from text model fallbacks.

​
Auth profiles

fased models auth add
fased models auth login --provider <id>
fased models auth setup-token
fased models auth paste-token
fased models auth login-github-copilot
fased models auth order get --provider <id>
fased models auth order set --provider <id> <profile-id> [profile-id...]
fased models auth order clear --provider <id>
models auth login runs a provider plugin’s auth flow (OAuth/API key). Use fased plugins list to see which providers are installed. Notes:
  • setup-token prompts for a setup-token value (generate it with claude setup-token on any machine).
  • paste-token accepts a token string generated elsewhere or from automation.
  • auth order sets or clears the per-Agent auth profile order for one provider.