Command line
capture
Capture the current Live set as a .vibrai YAML file
Output file path. Defaults to Captured.vibrai in CWD.
Overwrite the output file if it already exists.
Emit the YAML to stdout, do not write a file.
Overlay section metadata (category, tension, modifier, variation, scale overrides) AND the first template’s Automation from this prior .vibrai onto the captured project. Sections matched by id, falling back to position. Scene names always come from the captured set.
Suppress the lossy_arrangement_automation warning that capture emits when no —merge-with is provided and the captured arrangement_automation array is empty (the LOM-blind-spot for bouncer-produced envelopes).
Optional track handle (trk_42), to capture only this track; repeatable to select several. Session-level data (tempo, scale, scenes) is always captured in full.
capture-merge
Combine partial .vibrai files (each produced by capture —track-ids) into one project
Absolute path to a partial .vibrai file to combine; repeatable, in canonical order (the first entry wins any session-metadata drift warning).
Output file path for the merged project.
Overwrite the output file if it already exists.
MCP tools
capture_project
Capture the running Live set as a .vibrai YAML file. Set dry_run=true to return the YAML in the response without writing to disk. Set merge_with=<path> to overlay section metadata (category, tension, modifier, variation, scale overrides) AND Templates[0].Automation from a previously-authored .vibrai onto the captured project — Live’s LOM cannot read these, so capture cannot derive them. When no merge_with is supplied and the captured arrangement_automation array is empty, the summary includes a lossy_arrangement_automation warning explaining the LOM gap; pass warn_lossy_automation=false to suppress it.
String
required
Absolute file path to write the captured .vibrai YAML to.
Boolean
Overwrite the file if it already exists.
Boolean
Return the YAML in the response without writing.
String
Optional absolute path to a prior .vibrai whose section metadata AND Templates[0].Automation should overlay the captured sections (matched by Section.Id, falling back to Position). Scene names always come from the captured set.
Boolean
When true (default) AND merge_with is null AND captured arrangement_automation is empty, emit a lossy_arrangement_automation warning string in the summary explaining the LOM gap. Set to false to suppress the warning.
String[]
Optional track handles from list_tracks, e.g. [“trk_42”], to capture only these tracks. Session-level data (tempo, scale, scenes) is always captured in full regardless. Combine multiple capture_project calls with different track_ids, then merge_captures, to keep any single call well under any client-side timeout on a large set.
merge_captures
Combine N partial .vibrai files (each produced by capture_project with a track_ids filter) into one project. Track-id collisions across sources are an error naming the colliding ids. Session-level metadata (tempo/scale/scene names) drifting between sources is a warning, not an error — the FIRST path in sources is canonical for those fields.
String[]
required
Absolute paths to the partial .vibrai files to combine, in canonical order (the first entry wins any session-metadata drift warning).
String
required
Absolute file path to write the merged .vibrai YAML to.
Boolean
Overwrite the file if it already exists.