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.

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

Command line

generate

Generate clips and arrangement from an .vibrai project file
vibrai generate --project <PATH> --force --dry-run --seed <VALUE> --allow-skip
--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.

plan

Plan a composition from an .vibrai project file without writing to Live
vibrai plan --project <PATH> --seed <VALUE>
--project
Path to .vibrai file (default: Untitled.vibrai in CWD)
--seed
Override the project’s T2mHash seed for this run

MCP tools

plan

Plan a composition from an .vibrai file without writing to Live. Returns a slim summary.
{
  "tool": "plan",
  "arguments": {
    "project_path": "<String>",
    "seed": "<Nullable`1>"
  }
}
project_path
String
required
Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)
seed
Nullable`1
required
Optional seed override

generate

Plan + render a composition into Live’s session view and arrangement view. Requires force=true to overwrite existing clips. By default, fails fast when any ArrangementAutomationEntry cannot be resolved against the live device tree; pass allow_skip=true to log warnings and continue.
{
  "tool": "generate",
  "arguments": {
    "project_path": "<String>",
    "force": "<Boolean>",
    "allow_skip": "<Boolean>",
    "seed": "<Nullable`1>"
  }
}
project_path
String
required
Path to the .vibrai file (defaults to Untitled.vibrai in CWD when omitted)
force
Boolean
required
Overwrite existing session clips and arrangement content
allow_skip
Boolean
required
Continue when arrangement-automation entries cannot be resolved; default fails fast.
seed
Nullable`1
required
Optional seed override