> ## 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.

# Introduction

> Vibrai is an arrangement engine for Ableton Live — drive it from the CLI or from an AI agent over MCP.

Vibrai is an engine that gives you programmatic control over Ableton Live: tracks, clips, MIDI notes, automation envelopes, and the full arrangement view. It exposes a generative arrangement engine that turns a small YAML project file (`.vibrai`) into a complete Live session — section by section, part by part — with scale-aware MIDI and automation.

Two equal surfaces expose the same engine. The **CLI** (`vibrai`) is scriptable, deterministic, and pipe-friendly. The **MCP server** lets an AI assistant like Claude drive Live in plain language while you watch. Both surfaces share the same bridge, the same project files, and the same underlying operations — so you can generate a song through Claude, then iterate on it from the terminal, or vice versa.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    From zero to a generated arrangement in under five minutes, shown both ways.
  </Card>

  <Card title="CLI Overview" icon="terminal" href="/cli/overview">
    How the CLI is structured: branches, global flags, JSON output, and exit codes.
  </Card>

  <Card title="MCP Overview" icon="robot" href="/mcp/overview">
    Connect an AI client and drive Ableton Live with Vibrai's tools.
  </Card>

  <Card title="Concepts" icon="book" href="/concepts">
    The ideas behind Vibrai: `.vibrai` files, generators, and theme & variation.
  </Card>
</CardGroup>