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.

Read and write MIDI notes in clips.

​
Command line

​
note list

List notes in a clip 
vibrai note list <track> <scene>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)

​
note set

Replace all notes in a clip 
vibrai note set <track> <scene> --json-data <JSON> --file <PATH>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)
​
--json-data
Notes as JSON array
​
--file
Path to JSON file containing notes array

​
note add

Add notes to a clip 
vibrai note add <track> <scene> --json-data <JSON> --file <PATH>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)
​
--json-data
Notes as JSON array
​
--file
Path to JSON file containing notes array

​
MCP tools

​
list_notes

List all notes in a clip. 
{
  "tool": "list_notes",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
write_notes

Replace all notes in a clip with the given list. 
{
  "tool": "write_notes",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>",
    "notes": "<NoteEvent[]>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
notes
NoteEvent[]
required
Notes to write (replaces all existing).

​
add_notes

Append notes to a clip without removing existing notes. 
{
  "tool": "add_notes",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>",
    "notes": "<NoteEvent[]>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
notes
NoteEvent[]
required
Notes to append.