Command line
clip list
List clips for a track
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
clip get
Get a clip by track and scene handle
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
clip create
Create a clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
default:"4"
Clip length in bars (default: 4)
clip delete
Delete a clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
clip fire
Fire a clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
clip stop
Stop a playing session clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
clip rename
Rename a clip by track and scene handle
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
New clip name
clip set-color
Set a session clip’s colour by Live palette index
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …).
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …).
required
Live colour palette index, 0-69.
clip clear-all
Clear every session and arrangement clip in the set, keeping tracks, instruments, effects and mixer settings
Confirm the destructive clear. Without this flag, print what would be cleared and exit non-zero without changing anything.
Also clear audio tracks. Default off — audio clips reference recorded or imported material a generation run will never recreate.
Track handle (trk_42) OR 1-based position OR ordinal word (as printed by
vibrai track list) to clear. Repeatable: —tracks trk_5 —tracks 3. Omit to clear every eligible track.clip envelope get
Read automation envelope(s) on a session-view clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
Device ID, 1-based position number, or name substring. Provide together with —param, or omit both for a bulk read of every envelope on the clip.
Parameter index (from ‘vibrai automation params’) or display name. Provide together with —device, or omit both for a bulk read.
clip envelope write
Write an automation envelope onto a session-view clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Device ID, 1-based position number, or name substring
required
Parameter index from ‘vibrai automation params’, or the param name (e.g., “Cutoff”)
Automation points as JSON array (free-form). Mutually exclusive with —curve.
Path to JSON file containing automation points array. Mutually exclusive with —curve.
Curve shape: LinearUp|LinearDown|ExpUp|ExpDown|Sine|Triangle|SawUp|SawDown|Hold|Wander. Mutually exclusive with —json-data/—file.
Curve length in beats. Required when —curve is given.
Curve start value as a fraction of the parameter’s travel (0 = its min, 1 = its max); scaled to native units at write time. Defaults to 0. For Linear/Exp/Sine/Triangle/Saw/Hold.
Curve end value as a fraction of the parameter’s travel (0 = min, 1 = max). Defaults to 1. For Linear/Exp/Sine/Triangle/Saw.
Number of teeth (for SawUp/SawDown only). Default 4.
Wander center as a fraction of the parameter’s travel. Defaults to 0.5 (midpoint).
Wander deviation amplitude as a fraction of the parameter’s travel (must be > 0 and <= 1).
Wander knot density (0=jittery, 1=lazy drift).
Wander RNG seed. Auto-generated if omitted.
clip envelope clear
Clear automation envelope(s) on a session-view clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
Device ID, 1-based position number, or name substring. Provide together with —param, or omit both to clear every envelope on the clip.
Parameter index or display name. Provide together with —device, or omit both to clear every envelope on the clip.
MCP tools
list_clips
List all clip slots for a track (a track handle). Empty slots are included as empty entries. Returns clip metadata only — notes are stripped for performance; call get_clip for note detail.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
get_clip
Get a single clip by track and scene (both handles). Returns null if the slot is empty. Includes the clip’s notes; use list_clips for a notes-less summary across a track.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
create_clip
Create an empty MIDI clip at the given track and scene (both handles).
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
Double
required
Clip length in bars (e.g. 4.0)
delete_clip
Delete the clip at the given track and scene (both handles).
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
fire_clip
Trigger the clip at the given track and scene (both handles).
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
stop_clip
Stop the playing clip at the given track and scene (both handles). The inverse of fire_clip.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
set_clip_name
Rename the clip at the given track and scene (both handles).
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
String
required
New clip name
get_clip_envelopes
Read automation envelope(s) on a session-view clip. Omit both deviceId and paramId for a bulk read of every envelope on the clip; supply BOTH to read one specific (device, param) envelope. Supplying exactly one is an error.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
String
1-based position: 1 = the first device in the chain, 2 = the second. NOT the
device_id list_devices reports — that field is 0-based, so add 1 to it. A name substring also works (case-insensitive, must match exactly one device).. Provide together with paramId, or omit both for a bulk read of every envelope on the clip.String
Parameter index (from list_automation_params .param_id column) OR the parameter’s display name. Provide together with deviceId, or omit both for a bulk read.
write_clip_envelope
Write an automation envelope onto a session-view clip (replaces existing points). Provide EITHER points (free-form) OR curve_spec (compact shape — Sine, Wander, etc — expanded server-side). Returns the readback so you can verify what landed.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
String
required
1-based position: 1 = the first device in the chain, 2 = the second. NOT the
device_id list_devices reports — that field is 0-based, so add 1 to it. A name substring also works (case-insensitive, must match exactly one device).String
required
Parameter index (from list_automation_params .param_id column) OR the parameter’s display name (.param_name column)
AutomationPoint[]
Automation points (time + value). Mutually exclusive with curve_spec.
CurveSpec
Compact curve specification. Mutually exclusive with points. Shape can be LinearUp/LinearDown/ExpUp/ExpDown/Sine/Triangle/SawUp/SawDown/Hold/Wander.
clear_clip_envelopes
Clear automation envelope(s) on a session-view clip. Supply BOTH deviceId and paramId to remove one specific envelope; omit BOTH to remove every envelope on the clip. Supplying exactly one is an error.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim.
String
1-based position: 1 = the first device in the chain, 2 = the second. NOT the
device_id list_devices reports — that field is 0-based, so add 1 to it. A name substring also works (case-insensitive, must match exactly one device).. Provide together with paramId, or omit both to clear every envelope on the clip.String
Parameter index or display name. Provide together with deviceId, or omit both to clear every envelope on the clip.
clear_clips
Remove EVERY session clip and arrangement clip from the Live set, and neutralise Vibrai-authored automation, while KEEPING tracks, instruments/plug-ins, audio effects, mixer settings, track names/colours and scenes — so the set’s rig can be reused for another generation run. The non-destructive sibling of clear_project, which deletes whole tracks instead. Destructive: requires confirm=true (parity with the CLI’s vibrai clip clear-all --yes); without it, reports what would be cleared and changes nothing. Clears all non-group MIDI tracks by default (audio is opt-in, since audio clips reference recorded material a generation run cannot recreate). NOTE: automation drawn by hand in Live cannot be removed by any LOM mechanism and may remain audible — the result says so in warnings.
Boolean
Confirm the destructive clear (CLI —yes equivalent). Must be true to proceed; confirm with the user first.
Boolean
Also clear audio tracks. Default false — audio clips reference recorded or imported material a generation run will never recreate.
String[]
Track handles from list_tracks, e.g. “trk_42”. Copy verbatim. Omit to clear every eligible track.