ferraus jobs list
List background jobs started with --async
Synopsis
ferraus jobs list [options]
What it does
List background jobs started with --async
Examples
Every background job with its state (running, done, failed, cancelled)
ferraus jobs list
The job list as JSON: job_id, state, percent, and the original command line
ferraus jobs list --json
Start a long separation in the background, then see it listed
ferraus separate song.wav --async --json && ferraus jobs list
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 |
| 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_jobs_list - Schema:
ferraus schema jobs list - Pipeline:
{ op: jobs list, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "jobs list", "defaults": {}}