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
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Processing failed |
| 2 | Usage or parameter error |
| 3 | Input missing or unreadable |
| 5 | Model not cached and downloads disabled |
| 6 | Model download or verification failed |
| 8 | Cancelled |
| 10 | Network error |
| 70 | Internal error (bug) |
Common mistakes
- Expecting human-readable text when scripting: add
--jsonfor 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": {}}