Command line
capture
Capture the current Live set as a .vibrai YAML file
--out
Output file path. Defaults to Captured.vibrai in CWD.
--force
Overwrite the output file if it already exists.
--dry-run
Emit the YAML to stdout, do not write a file.
--merge-with
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.
--no-warn-lossy-automation
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).
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.
Absolute file path to write the captured .vibrai YAML to.
Overwrite the file if it already exists.
Return the YAML in the response without writing.
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.
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.