Arrangement - Vibrai

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_automation — 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": {}
}

​Command line

​arrangement get-clips

​arrangement place

​arrangement delete

​arrangement clear-scoped

​arrangement clear-all

​MCP tools

​get_arrangement_clips

​place_arrangement_clip

​delete_arrangement_clip

​clear_arrangement_for_tracks

​clear_arrangement_all

Command line

`arrangement get-clips`

`arrangement place`

`arrangement delete`

`arrangement clear-scoped`

`arrangement clear-all`

MCP tools

`get_arrangement_clips`

`place_arrangement_clip`

`delete_arrangement_clip`

`clear_arrangement_for_tracks`

`clear_arrangement_all`