Generation - Vibrai

Generate or plan a composition from a .vibrai project file.

Command line

`generate`

Generate clips and arrangement from a .vibrai project file

vibrai generate --project <PATH> --force --dry-run --seed <VALUE> --allow-skip --with-instruments --stock-only --on-existing-tracks <MODE> --keep-empty-clips --swing <PCT> --humanize <PCT> --ornaments <PCT> --dropout <PCT>

--project

Path to .vibrai file (default: Untitled.vibrai in CWD)

--force

Overwrite existing session clips and arrangement content in project tracks

--dry-run

Plan only — do not call the bridge

--seed

Override the project’s T2mHash seed for this run

--allow-skip

Continue when arrangement-automation entries cannot be resolved; default fails fast.

--with-instruments

After rendering, load each part’s default instrument (drum kits for drum parts) so the song is audible.

--stock-only

Resolve instruments from stock content only: skips explicit defaults.instruments overrides AND tagged instruments, using genre stock defaults + built-in generic. For demos/testing without third-party packs.

--on-existing-tracks

How to treat existing MIDI tracks: replace (delete them) or append (keep, add after last MIDI track). Default: append. Audio/return tracks are always left in place.

--keep-empty-clips

Keep generator-produced clips that resolve to zero notes. By default these are skipped, leaving a gap in both session and arrangement views. Authored literal empty clips are always kept.

--swing

Swing amount 0-100 (0 straight, 100 hard triplet). Overrides genre/preset default.

--humanize

Velocity/timing jitter 0-100. Overrides genre/preset default.

--ornaments

Grace-note/roll density 0-100. Overrides genre/preset default.

--dropout

Tension-section note thinning 0-100. Overrides genre/preset default.

`plan`

Plan a composition from a .vibrai project file without writing to Live

vibrai plan --project <PATH> --seed <VALUE> --keep-empty-clips --swing <PCT> --humanize <PCT> --ornaments <PCT> --dropout <PCT>

--project

Path to .vibrai file (default: Untitled.vibrai in CWD)

--seed

Override the project’s T2mHash seed for this run

--keep-empty-clips

Keep generator-produced clips that resolve to zero notes. By default these are skipped, leaving a gap in both session and arrangement views. Authored literal empty clips are always kept.

--swing

Swing amount 0-100 (0 straight, 100 hard triplet). Overrides genre/preset default.

--humanize

Velocity/timing jitter 0-100. Overrides genre/preset default.

--ornaments

Grace-note/roll density 0-100. Overrides genre/preset default.

--dropout

Tension-section note thinning 0-100. Overrides genre/preset default.

MCP tools

`plan`

Plan a composition from a .vibrai file without writing to Live. Returns a slim summary. Track ids in the summary (session_clips, arrangement_placements, instruments, current_tracks) are 1-based, matching list_tracks and load_device.

{
  "tool": "plan",
  "arguments": {
    "project_path": "<String>",
    "seed": "<Nullable`1>",
    "keep_empty_clips": "<Boolean>",
    "swing": "<Nullable`1>",
    "humanize": "<Nullable`1>",
    "ornament_density": "<Nullable`1>",
    "dropout": "<Nullable`1>"
  }
}

project_path

String

Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)

seed

Nullable`1

Optional seed override

keep_empty_clips

Boolean

Keep generator-produced clips that resolve to zero notes. Default false: such clips (and their arrangement placements) are skipped, leaving a gap. Authored literal empty clips are always kept.

swing

Nullable`1

Swing 0-100 (0 straight, 100 hard triplet); overrides genre/preset default

humanize

Nullable`1

Velocity/timing jitter 0-100; overrides genre/preset default

ornament_density

Nullable`1

Grace-note/roll density 0-100; overrides genre/preset default

dropout

Nullable`1

Tension-section note thinning 0-100; overrides genre/preset default

`generate`

Plan + render a composition into Live’s session view and arrangement view. force=true is required only when append re-renders onto an existing part track whose target slots are non-empty; replace implies consent and never requires force. By default, fails fast when any ArrangementAutomationEntry cannot be resolved against the live device tree; pass allow_skip=true to log warnings and continue. Track ids in the summary (session_clips, arrangement_placements, instruments, current_tracks) are 1-based, matching list_tracks and load_device.

{
  "tool": "generate",
  "arguments": {
    "project_path": "<String>",
    "force": "<Boolean>",
    "allow_skip": "<Boolean>",
    "with_instruments": "<Boolean>",
    "stock_only": "<Boolean>",
    "on_existing_tracks": "<String>",
    "seed": "<Nullable`1>",
    "keep_empty_clips": "<Boolean>",
    "swing": "<Nullable`1>",
    "humanize": "<Nullable`1>",
    "ornament_density": "<Nullable`1>",
    "dropout": "<Nullable`1>"
  }
}

project_path

String

Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)

force

Boolean

Overwrite existing session clips and arrangement content

allow_skip

Boolean

Continue when arrangement-automation entries cannot be resolved; default fails fast.

with_instruments

Boolean

After rendering, load each part’s default instrument (drum kits for drum parts) so the song is audible.

stock_only

Boolean

on_existing_tracks

String

How to treat MIDI tracks already in the Live set: “replace” (delete existing MIDI tracks, audio/return untouched) or “append” (keep them, add new tracks after the last MIDI track). Omit to receive a needs_decision result listing the current tracks.

seed

Nullable`1

Optional seed override

keep_empty_clips

Boolean

Keep generator-produced clips that resolve to zero notes. Default false: such clips (and their arrangement placements) are skipped, leaving a gap. Authored literal empty clips are always kept.

swing

Nullable`1

Swing 0-100 (0 straight, 100 hard triplet); overrides genre/preset default

humanize

Nullable`1

Velocity/timing jitter 0-100; overrides genre/preset default

ornament_density

Nullable`1

Grace-note/roll density 0-100; overrides genre/preset default

dropout

Nullable`1

Tension-section note thinning 0-100; overrides genre/preset default

​Command line

​generate

​plan

​MCP tools

​plan

​generate

Command line

`generate`

`plan`

MCP tools

`plan`

`generate`