Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vibrai.com/llms.txt

Use this file to discover all available pages before exploring further.

Place, delete, and clear arrangement-view clips.

​
Command line

​
arrangement get-clips

List arrangement clips for a track 
vibrai arrangement get-clips <track>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)

​
arrangement place

Place a session-view clip into the arrangement 
vibrai arrangement place <track> <scene> <start> --no-carry-envelopes --force
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Session-view scene number (1-based: 1, 2, … or first, second, …)
​
start
required
Arrangement start: bar.beat notation (e.g. 2.1 = bar 2, beat 1) or raw beats
​
--no-carry-envelopes
Skip session-clip envelope carry (default: envelopes carry as track-lane automation)
​
--force
Allow envelope carry even when existing destination-track automation would be clobbered

​
arrangement delete

Delete a single arrangement clip at (track, start-beat) 
vibrai arrangement delete <track> <start>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
start
required
Arrangement start: bar.beat notation (e.g. 5.1 = bar 5, beat 1) or raw beats

​
arrangement clear-scoped

Clear arrangement clips for specific tracks 
vibrai arrangement clear-scoped <tracks>
​
tracks
required
One or more track numbers to clear (1-based, space-separated)

​
arrangement clear-all

Clear all arrangement clips 
vibrai arrangement clear-all

​
MCP tools

​
get_arrangement_clips

List the arrangement-view clips for a track. 
{
  "tool": "get_arrangement_clips",
  "arguments": {
    "track_id": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
place_arrangement_clip

Copy the session-view clip at (track_id, source_scene_index) 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. 
{
  "tool": "place_arrangement_clip",
  "arguments": {
    "track_id": "<String>",
    "source_scene_index": "<String>",
    "start_beat": "<String>",
    "carry_envelopes": "<Boolean>",
    "force": "<Boolean>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
source_scene_index
String
required
Session-view scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
start_beat
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’)
​
carry_envelopes
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_arrangement_envelopes_ledger — the LOM read-back path returns empty for arrangement clips written this way. See recipe write_arrangement_automation and recipe verify_arrangement_writes.
​
force
Boolean
Allow envelope carry even when existing track-lane automation would be clobbered (default: false).

​
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). 
{
  "tool": "delete_arrangement_clip",
  "arguments": {
    "track_id": "<String>",
    "start_beat": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
start_beat
String
required
Arrangement start: bar.beat notation (e.g. ‘2.3’ = bar 2, beat 3) or raw beats (e.g. ‘16’ or ‘16.0’)

​
clear_arrangement_for_tracks

Clear all arrangement-view clips for the specified tracks. 
{
  "tool": "clear_arrangement_for_tracks",
  "arguments": {
    "track_ids": "<String[]>"
  }
}
​
track_ids
String[]
required
Track numbers (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
clear_arrangement_all

Clear all arrangement-view clips across every track. 
{
  "tool": "clear_arrangement_all",
  "arguments": {}
}