Command line
arrangement get-clips
List arrangement clips for a track
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
arrangement place
Place a session-view clip into the arrangement
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Session-view scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …) — identifies the source clip’s scene
required
Arrangement start: bar.beat notation (e.g. 2.1 = bar 2, beat 1) or raw beats
Skip session-clip envelope carry (default: envelopes carry as track-lane automation)
Allow envelope carry even when existing destination-track automation would be clobbered
Path to the .vibrai file whose declared meter governs the placed clip’s length (default: the project in the CWD when present, else Live’s transport meter)
arrangement set-props
Rename or recolour an arrangement clip
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …).
required
1-based clip number from ‘vibrai arrangement get-clips’.
New clip name. Omit to leave unchanged.
Live colour palette index, 0-69. Omit to leave unchanged.
arrangement delete
Delete a single arrangement clip at (track, start-beat)
required
Track handle (trk_42) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
Arrangement start: bar.beat notation (e.g. 5.1 = bar 5, beat 1) or raw beats
Path to the .vibrai file whose declared meter positions bar.beat inputs (defaults to <current-directory-name>.vibrai; falls back to Live’s transport, then 4/4)
arrangement clear-scoped
Clear arrangement clips for specific tracks
required
One or more track handles (trk_42) OR 1-based numbers OR ordinals to clear (space-separated)
arrangement clear-all
Clear all arrangement clips
MCP tools
get_arrangement_clips
List the arrangement-view clips for a track.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
place_arrangement_clip
Copy the session-view clip at (track, source_scene) into the arrangement on the same track, starting at the given beat. By default, session-clip envelopes are also carried into the arrangement as track-lane automation; pass carry_envelopes: false to disable. Refuses with ARRANGEMENT_OVERLAP if existing destination-track automation would be clobbered; pass force: true to override.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Session-view scene handle from list_scenes, e.g. “scn_7”. Copy verbatim — identifies the source clip’s scene.
String
required
Start position in arrangement: bar.beat notation (e.g. ‘2.3’ = bar 2, beat 3) or raw beats (e.g. ‘8’ or ‘8.0’)
Boolean
Carry every session-clip envelope into the arrangement via a single transactional bounce. Returns carried_envelopes:N only after all N envelopes are committed; on any failure the placed clip is removed and the arrangement is left unchanged. Verify writes via get_automation — the LOM read-back path returns empty for arrangement clips written this way. See recipe
write_arrangement_automation and recipe verify_arrangement_writes.Boolean
Allow envelope carry even when existing track-lane automation would be clobbered (default: false).
String
Path to the .vibrai file whose declared meter should govern the placed clip’s length. Omitted: the default project in the CWD is consulted when present, otherwise Live’s transport meter is used.
delete_arrangement_clip
Delete a single arrangement-view clip on a track at the given start beat (surgical — does not affect other clips on the track or track-level automation envelopes).
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim.
String
required
Arrangement start: bar.beat notation (e.g. ‘2.3’ = bar 2, beat 3) or raw beats (e.g. ‘16’ or ‘16.0’)
String
Path to the .vibrai file whose declared meter positions bar.beat inputs (defaults to <current-directory-name>.vibrai in the working directory; falls back to Live’s transport, then 4/4)
clear_arrangement_for_tracks
Clear all arrangement-view clips for the specified tracks.
String[]
required
Track handles from list_tracks, e.g. “trk_42”. Copy verbatim.
clear_arrangement_all
Clear all arrangement-view clips across every track.
set_arrangement_clip_props
Rename and/or recolour an arrangement clip. Pass at least one of name or color_index. The clip is addressed by its track handle and its 1-based clip number from get_arrangement_clips. Colours are Live palette indices, not RGB. For session clips use set_clip_name and set_clip_color instead.
String
required
Track handle from list_tracks, e.g. “trk_42”. Copy verbatim; not a position number.
Int32
required
1-based clip number from get_arrangement_clips.
String
New clip name. Omit to leave unchanged.
Nullable`1
Live colour palette index, 0-69. Omit to leave unchanged.