Command line
genre list
List installed genre libraries
genre presets
List presets in a genre library
required
Genre id or display name (run ‘vibrai genre list’)
genre import-songsketch
Convert a Song Sketch lib JSON file to a .vibraigenre
required
Path to a Song Sketch lib JSON file
Output directory (defaults to ~/.vibrai/genres)
genre apply
Apply a genre+preset to a .vibrai project
Genre id or display name (run ‘vibrai genre list’).
Preset id or display name within the genre (from ‘vibrai genre presets <genre>’).
Path to the .vibrai file (default: <current-directory-name>.vibrai in the working directory)
(deprecated) Use positional <genre> instead. Will be removed in the next minor release.
(deprecated) Use positional <preset> instead. Will be removed in the next minor release.
Confirm destructive overwrite of sections / parts / templates / arrangement / generation
Persist Ableton ’#’ track auto-numbering into the project (applied when you later run generate).
Persist ’#’ track auto-numbering as OFF in the project (overrides env / an existing setting).
Target scale root: note name (C, C#, Db, …, B) or pitch class 0–11. Omit to use the genre’s own default scale.
Target scale: Major, Ionian, Dorian, Phrygian, Lydian, Mixolydian, Minor, Aeolian, Locrian. Omit to use the genre’s own default scale.
genre extract
Extract a genre from the open Live set into a .vibraigenre
Genre display name; the filename slug derives from it. Defaults to the open Live set’s name.
Output directory (defaults to ~/.vibrai/genres so the genre is immediately applicable)
Append the set as a new preset to this existing user genre instead of creating a file
Name of the preset this set becomes (defaults to the set name)
Also embed literal note phrases (writes format v4 with playback support)
default:"auto"
auto|arrangement|session — auto uses the arrangement when it has clips, else the session
Classification override as <trackId>:<PartType>, repeatable (track ids as shown in the report)
Overwrite an existing target .vibraigenre
MCP tools
list_genres
List installed genre libraries. Returns each genre’s name (slug; other tools accept either the slug or the display name), display name, sub-genres, default BPM, and preset count. Embedded resources ship with Vibrai; users can override or add entries via ~/.vibrai/genres/<name>.vibraigenre. Call get_skill first to load the Vibrai operational playbook.
list_genre_presets
List presets in a genre library. Each entry has id (use with apply_genre / init_project —preset), display name, sub-genre, section/part counts, and an instrumentation summary (snake_case PartType -> stock instrument path, resolved for the preset’s own sub-genre) from the genre’s defaults table — omitted when the genre has none.
String
required
Genre id (slug from list_genres) or display name.
apply_genre
Materialize a genre+preset into a .vibrai project at the given path. Destructive: overwrites sections, parts, templates, arrangement.blueprint, and generation — requires confirm=true (parity with the CLI’s genre apply --yes); refuses without modifying the project otherwise. Preserves meta.name, meta.als_path, and Defaults.NumberTracks from the existing project if present (number_tracks omitted). Note: the preset_id parameter was renamed to preset for CLI/MCP naming parity; update any callers. Call get_skill first to load the Vibrai operational playbook.
String
required
Genre id (slug from list_genres) or display name.
String
required
Preset id or display name within the genre (from list_genre_presets).
String
required
Absolute path to the .vibrai project file.
Boolean
Confirm the destructive overwrite (CLI —yes equivalent). Must be true to proceed; confirm with the user first when the project already has content.
Nullable`1
Persist Ableton ’#’ track auto-numbering into the project. Null preserves the existing project’s setting.
String
Optional target scale root: note name (C, C#, Db, …, B) or pitch class 0–11. Omit to use the genre’s own default scale.
String
Optional target scale: Major, Ionian, Dorian, Phrygian, Lydian, Mixolydian, Minor, Aeolian, Locrian. Omit to use the genre’s own default scale.
extract_genre
Extract a genre from the open Live set into a .vibraigenre file. Reads tempo, scale, tracks, clips, notes, and envelopes; classifies tracks into parts (report shows each decision); detects sections; and writes a generative genre usable by apply_genre. Set faithful=true to also embed literal note phrases so regeneration seeds from the source riffs. Set into_genre=<user genre> to append this set as a new preset instead of creating a file. Re-run with part_overrides to correct classifications — extraction never mutates the Live set.
String
Genre display name; filename slug derives from it. Defaults to the open set’s name.
String
Output directory. Defaults to ~/.vibrai/genres so the genre is immediately applicable.
String
Append as a new preset to this existing user genre instead of creating a new file.
String
Name of the preset this set becomes. Defaults to the set name.
Boolean
Also embed literal note phrases (writes format v4 with playback support).
String
auto|arrangement|session — auto uses the arrangement when it has clips, else the session.
Dictionary<String, String>
Classification overrides: track id (as shown in the report) → PartType, e.g. {“3”: “hi_hat”}.
Boolean
Overwrite an existing target file.