Install

Install the Vibrai device, remote script, Ableton templates, and Claude Desktop extension bundle.

Command line

`install device`

Install the Vibrai Max-for-Live device + JS bridge into Live’s User Library

vibrai install device --force --source <PATH> --dest <PATH> --user <NAME>

Overwrite an existing install whose files differ from the source.

[advanced] Override the source directory (test/debug use).

[advanced] Override the destination directory (test/debug use).

Install into <name>‘s home directory instead of the current user’s. Used by the macOS .pkg postinstall to deposit files into the real installing user’s Ableton User Library when running as root.

`install remote-script`

Install the Vibrai Python remote script into Live’s User Library

vibrai install remote-script --force --source <PATH> --dest <PATH> --user <NAME>

Overwrite an existing install whose files differ from the source.

[advanced] Override the source directory (test/debug use).

[advanced] Override the destination directory (test/debug use).

`install templates`

Install the Vibrai Starter and Vibrai Demo Ableton templates into Live’s User Library (always overwrites)

vibrai install templates --source <PATH> --dest <PATH> --user <NAME>

[advanced] Override the source directory (test/debug use).

[advanced] Override the destination directory (test/debug use).

`install claude-extension`

Deploy the Claude Desktop extension bundle (Vibrai.mcpb) into Live’s User Library, where you can find it in Finder

vibrai install claude-extension --reveal --force --source <PATH> --dest <PATH> --user <NAME>

Open a Finder window with the deployed Vibrai.mcpb selected, ready to drag into Claude Desktop → Settings → Extensions.

Overwrite an existing install whose files differ from the source.

[advanced] Override the source directory (test/debug use).

[advanced] Override the destination directory (test/debug use).

`install all`

Install the M4L device, the Python remote script, the Ableton templates, and the Claude Desktop extension bundle

vibrai install all --force --user <NAME> --reveal

Overwrite existing installs whose files differ from the source.

Open a Finder window with the deployed Vibrai.mcpb selected. Used by the macOS .pkg postinstall so the bundle is waiting for the user when the installer finishes.

MCP tools

`install_device`

Copy the bundled vibrai.amxd Max-for-Live device + JS bridge files into the user’s Ableton User Library. By default refuses to overwrite a modified install — pass force=true to clobber. Run once after installing the .mcpb extension; then open Ableton Live and drag vibrai.amxd onto a track. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.

{
  "tool": "install_device",
  "arguments": {
    "force": "<Boolean>",
    "source_override": "<String>",
    "dest_override": "<String>"
  }
}

Boolean

Overwrite an existing install whose files differ from the source (default false)

String

[advanced] Test-only override for the source directory

String

[advanced] Test-only override for the destination directory

`install_vibrai_remote_script`

Copy the bundled Vibrai Python remote script into Live’s User Library Remote Scripts directory. By default refuses to overwrite a modified install — pass force=true to clobber. After install, restart Live and enable ‘Vibrai’ under Preferences → Link/Tempo/MIDI → Control Surface. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.

{
  "tool": "install_vibrai_remote_script",
  "arguments": {
    "force": "<Boolean>",
    "source_override": "<String>",
    "dest_override": "<String>"
  }
}

Boolean

Overwrite an existing install whose files differ from the source (default false)

String

[advanced] Test-only override for the source directory

String

[advanced] Test-only override for the destination directory

`install_templates`

Copy the bundled “Vibrai Starter” (blank, bridge preloaded on a Return track) and “Vibrai Demo” (a ready-to-play loop) Ableton Live Set templates into your Ableton User Library’s Templates folder. Always overwrites — templates are refreshed on every install/update and are not meant to be hand-edited in place. Returns the source/destination paths, status (Installed | AlreadyUpToDate), and the list of files.

{
  "tool": "install_templates",
  "arguments": {
    "source_override": "<String>",
    "dest_override": "<String>"
  }
}

String

[advanced] Test-only override for the source directory

String

[advanced] Test-only override for the destination directory

`install_claude_extension`

Deploy the Claude Desktop extension bundle (Vibrai.mcpb) from Vibrai’s program directory into the user’s Ableton User Library at ‘User Library/Vibrai/Vibrai.mcpb’, where it is visible in Finder — the program directory (/usr/local/lib/vibrai) is hidden by default on macOS. Pass reveal=true to also open a Finder window with the bundle selected, ready to drag into Claude Desktop → Settings → Extensions. By default refuses to overwrite a deployed bundle that differs from the source — pass force=true to clobber. Returns status Installed | AlreadyUpToDate | SkippedNoSource; SkippedNoSource is NOT an error — it means no .mcpb was built for this platform (Windows never produces one) or this is a dev tree. Installing the bundle into Claude Desktop is still a manual drag; this tool only makes the file findable.

{
  "tool": "install_claude_extension",
  "arguments": {
    "force": "<Boolean>",
    "reveal": "<Boolean>",
    "source_override": "<String>",
    "dest_override": "<String>"
  }
}

Boolean

Overwrite a deployed bundle that differs from the source (default false)

Boolean

Open a Finder window with the deployed bundle selected (default false, macOS only)

String

[advanced] Test-only override for the source directory

String

[advanced] Test-only override for the destination directory

`install_all`

Install the Max-for-Live device, Python remote script, Ableton templates, and Claude Desktop extension bundle in one call — equivalent to install_device + install_vibrai_remote_script + install_templates + install_claude_extension run in sequence. Stops at the first failure (each step must succeed before the next runs). Templates always overwrite regardless of force. The Claude Desktop bundle reports SkippedNoSource when no .mcpb exists for this platform, which is not a failure. Returns per-target results (device, remote_script, templates, claude_extension).

{
  "tool": "install_all",
  "arguments": {
    "force": "<Boolean>",
    "reveal": "<Boolean>"
  }
}

Boolean

Overwrite existing device/remote-script installs whose files differ from the source (default false). Templates always overwrite regardless of this flag.

Boolean

Open a Finder window with the deployed Claude Desktop bundle selected (default false, macOS only)

Getting Started

Guides

Reference

Help

Changelog

Blog

Command line

`install device`

`install remote-script`

`install templates`

`install claude-extension`

`install all`

MCP tools

`install_device`

`install_vibrai_remote_script`

`install_templates`

`install_claude_extension`

`install_all`

​Command line

​install device

​install remote-script

​install templates

​install claude-extension

​install all

​MCP tools

​install_device

​install_vibrai_remote_script

​install_templates

​install_claude_extension

​install_all

Command line

`install device`

`install remote-script`

`install templates`

`install claude-extension`

`install all`

MCP tools

`install_device`

`install_vibrai_remote_script`

`install_templates`

`install_claude_extension`

`install_all`