ferraus models prune

Remove cached models no tier uses, stale partial downloads, and enforce the cache budget

Synopsis

ferraus models prune [options]

What it does

Remove cached models no tier uses, stale partial downloads, and enforce the cache budget

Examples

Show what would be removed

ferraus models prune --dry-run

Delete unused models and partial downloads, then enforce the cache budget

ferraus models prune

Prune and list every removed file with its size as JSON

ferraus models prune --json

Global options

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

Exit codes

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
5Model not cached and downloads disabled
6Model download or verification failed
8Cancelled
10Network error
70Internal error (bug)

Common mistakes

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

For models

  • MCP tool: ferraus_models_prune
  • Schema: ferraus schema models prune
  • Pipeline: { op: models prune, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "models prune", "defaults": {}}