Command line
drums map show
Show the project drum map (part-type → pitch overrides)
Path to the .vibrai file (default: <current-directory-name>.vibrai in the working directory)
drums map set
Set drum map entries (merged), e.g. snare=40 hi_hat=42
required
Drum map entries like snare=40 hi_hat=42 (keys: bd, snare, hi_hat, hi_hat_plus, percussion, crash, fill, roll, drums)
Path to the .vibrai file (default: <current-directory-name>.vibrai in the working directory)
drums map clear
Clear the drum map, or only the named part keys
Drum part keys to remove; omit to clear the whole map
Path to the .vibrai file (default: <current-directory-name>.vibrai in the working directory)
drums retarget
Re-resolve drum pitches against current kits and remap written notes (kit-swap fixer)
Track handle (trk_42) OR 1-based number OR ordinal; repeatable to limit the retarget
Preview without remapping or saving
Path to the .vibrai file (default: <current-directory-name>.vibrai in the working directory)
MCP tools
get_drum_map
Show the project’s drum map: explicit drum-part→pitch overrides used as the first rung of drum-pitch resolution. Empty map = fully automatic (pad names, then GM).
String
Path to the .vibrai file (defaults to <current-directory-name>.vibrai in the working directory when omitted)
set_drum_map
Set drum map entries (merged into the existing map) like [“snare=40”,“hi_hat=42”]. Keys are drum part types (bd, snare, hi_hat, hi_hat_plus, percussion, crash, fill, roll, drums); pitches 0-127. Mapped pitches win over pad-name matching at generate time; run retarget_drums to move already-written notes.
String[]
required
Entries like “snare=40”
String
Path to the .vibrai file (defaults to <current-directory-name>.vibrai in the working directory when omitted)
clear_drum_map
Clear the project drum map entirely, or only the named drum part keys (e.g. [“snare”]).
String[]
Drum part keys to remove; omit/empty to clear the whole map
String
Path to the .vibrai file (defaults to <current-directory-name>.vibrai in the working directory when omitted)
retarget_drums
Re-resolve every drum part’s pitch against the CURRENT kits (drum map → pad names → GM → snap) and remap already-written notes from the last-generated pitch to the new one — session and arrangement clips, server-side. Run after swapping a kit. dry_run previews without writing. Tracks with no recorded pitch (never generated with this feature) are skipped with a warning; use remap_pitch for those.
String
Path to the .vibrai file (defaults to <current-directory-name>.vibrai in the working directory when omitted)
String[]
Optional track handles from list_tracks, e.g. [“trk_42”], to limit the retarget. Copy verbatim.
Boolean
Preview the plan without remapping or saving