CLI Flags Reference

Pipeline tuning

These adjust the automatic pipeline. You usually don't need to change them.

Flag	Default	Description
--output-dir, -o	processed	Output directory
--dry-run	off	Show what would be done without writing files
--verbose, -v	off	Verbose output
--skip-existing	off	Skip already-processed files
--force	off	Overwrite existing files
--target-sr	48000	Target sample rate
--quantize-grid	1/16	MIDI quantization grid
--min-note-ms	40	Minimum MIDI note duration in ms
--separate-missing	off	Run stem separation on full mix
--separator	demucs	Separation backend: demucs or uvr

Advanced features (opt-in)

None of these run unless you explicitly pass the flag. Use them when the automatic results need manual correction or deeper analysis. Each has a detailed doc explaining the decisions it makes.

Flag	Description	Details
--choose-stems	Compare original vs AI-generated stems, recommend the better version	Stem Quality Judgment
--choose-grid-anchor	Analyze grid anchor candidates when the intro downbeat is unclear	Grid Anchor
--detect-sections	Identify arrangement sections (intro, verse, chorus, etc.)	Section Detection
--repair-midi	Detect key, flag out-of-key notes, fix stacked chords	Harmonic MIDI Repair
--requantize-midi	Re-snap notes to grid while preserving feel	MIDI Requantization
--requantize-mode	Requantize mode: strict, light, swing, triplet	MIDI Requantization
--reseparate	Re-run AI stem separation on the full mix or a specific stem	Separation Strategy
--apply	Write advanced feature changes to output files (without this, features only print analysis)	—

Export

Flag	Description
--export-als	Generate Ableton Live Set from processed output
--als-template	Path to Example.als template (auto-detected if not set)

See ALS Export for details on how the export works.