ferraus plugin list
List cached plugins
Synopsis
ferraus plugin list [options]
What it does
Lists the plugins found by the last scan (running one first if nothing is cached), plus any in --sound-path folders. Filter by kind or format.
Examples
Show instrument plugins
ferraus plugin list --instruments
CLAP effects as JSON
ferraus plugin list --effects --format clap --json
Every cached plugin, instruments and effects, in every format
ferraus plugin list
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
--instruments | flag | — | Only instruments |
--effects | flag | — | Only audio and note effects |
--format | list | — | Only these formats: clap, vst3 |
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 |
| 7 | Plugin crashed, timed out, or was not found |
| 8 | Cancelled |
| 70 | Internal error (bug) |
Common mistakes
- Expecting human-readable text when scripting: add
--jsonfor a stable machine result.
For models
- MCP tool:
ferraus_plugin_list - Schema:
ferraus schema plugin list - Pipeline:
{ op: plugin list, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "plugin list", "defaults": {}}