ferraus models registry update

Refresh the signed registry manifest, or pin a snapshot

Synopsis

ferraus models registry update [options]

What it does

Fetches the Ed25519-signed registry manifest and verifies it with the public key built into ferraus. Updates only advertise newer models: tiers keep the versions pinned by this release until you pass --model name@version or upgrade. --pin freezes a signed snapshot for reproducible deployments.

Examples

See whether newer models are available

ferraus models registry update

Freeze a snapshot for a deployment

ferraus models registry update --pin registry.json

Go back to following the live registry

ferraus models registry update --unpin

Fetch the signed manifest from a mirror

ferraus models registry update --url https://example.com/ferraus/registry.json

Options

Global options

Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.

Exit codes

Common mistakes

• Expecting human-readable text when scripting: add --json for a stable machine result.

For models

• MCP tool: ferraus_models_registry_update
• Schema: ferraus schema models registry update
• Pipeline: { op: models registry update, args: { ... } } (flag names with _ instead of -)
• fx stage: no

{"command": "models registry update", "defaults": {}}