vibrai is a Spectre.Console CLI that talks to Ableton Live through the Vibrai M4L bridge. Every command maps to an operation on the engine or the bridge — no Max for Live knowledge required.
Invocation model
Commands are organized into branches (subcommand groups) and a few top-level commands. Selected branches:
Run
vibrai --help to see the full tree. Run vibrai <branch> --help for subcommand detail. See the Reference section for the complete branch list and every flag, argument, and example.
Interactive shell
Running many commands in a row?vibrai shell opens a prompt where you type commands without the vibrai prefix, and without paying process startup for each one.
exit and quit both leave, help prints the command tree, and version prints the CLI version. Every other line is dispatched as if you had typed vibrai in front of it.
Global flags
These flags work on every command.--url, --log-level, and --log-file are pre-parsed and may appear before the subcommand name. --json must appear after the subcommand.
The flag is
--url, not --bridge-url. Set VIBRAI_URL once to avoid repeating it:
JSON output
Every command that returns data supports--json. The output schema matches the MCP tool response for the same operation, so the two surfaces are interchangeable in scripts and tests.
Exit codes
Missing required arguments produce a formatted
Error: … line with exit 255 — no stack traces.