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.

List, apply, and import genre libraries and presets.

​
Command line

​
genre list

List installed genre libraries 
vibrai genre list

​
genre presets

List presets in a genre library 
vibrai genre presets <genre>
​
genre
required
Genre id or display name (run ‘vibrai genre list’)

​
genre import-songsketch

Convert a Song Sketch lib JSON file to a .vibraigenre 
vibrai genre import-songsketch <json> --out <DIR>
​
json
required
Path to a Song Sketch lib JSON file
​
--out
Output directory (defaults to ~/.vibrai/genres)

​
genre apply

Apply a genre+preset to a .vibrai project 
vibrai genre apply [genre] [preset] [project-path] --genre <NAME> --preset <ID> --yes
​
genre
Genre id or display name (run ‘vibrai genre list’).
​
preset
Preset id within the genre (from vibrai genre presets &lt;genre>).
​
project-path
Path to .vibrai (default: ./project.vibrai)
​
--genre
(deprecated) Use positional <genre> instead. Will be removed in the next minor release.
​
--preset
(deprecated) Use positional <preset> instead. Will be removed in the next minor release.
​
--yes
Confirm destructive overwrite of sections / parts / templates / arrangement / generation

​
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. 
{
  "tool": "list_genres",
  "arguments": {}
}

​
list_genre_presets

List presets in a genre library. Each entry has id (use with apply_genre / init_project —preset), display name, sub-genre, and section/part counts. 
{
  "tool": "list_genre_presets",
  "arguments": {
    "genre": "<String>"
  }
}
​
genre
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. Preserves meta.name and meta.als_path from the existing project if present. Note: the preset_id parameter was renamed to preset for CLI/MCP naming parity; update any callers. 
{
  "tool": "apply_genre",
  "arguments": {
    "genre": "<String>",
    "preset": "<String>",
    "project_path": "<String>"
  }
}
​
genre
String
required
Genre id (slug from list_genres) or display name.
​
preset
String
required
Preset id within the genre (from list_genre_presets).
​
project_path
String
required
Absolute path to the .vibrai project file.