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

# Performance

> Drive Session-view playback: sequence scenes as a song.

Drive Session-view playback: sequence scenes as a song.

## Command line

### `play-song`

Play the song by firing session scenes in section order.

```bash theme={null}
vibrai play-song [project] --loop --stop
```

<ParamField path="project">
  Path to the .vibrai file (default: \<current-directory-name>.vibrai in the working directory)
</ParamField>

<ParamField path="--loop">
  Repeat the song until stopped (Ctrl-C).
</ParamField>

<ParamField path="--stop">
  Stop a performance already running (in this or another Vibrai process) instead of starting one.
</ParamField>

## MCP tools

### `play_song`

Play the song by firing Session scenes in section order, advancing at each section's bar boundary. Runs in the background; use stop\_performance to halt.

```json theme={null}
{
  "tool": "play_song",
  "arguments": {
    "project_path": "<String>",
    "loop": "<Boolean>"
  }
}
```

<ParamField path="project_path" type="String">
  Path to the .vibrai file (defaults to \<current-directory-name>.vibrai in the working directory when omitted)
</ParamField>

<ParamField path="loop" type="Boolean">
  Repeat the song until stopped
</ParamField>

### `stop_performance`

Stop the running play\_song performance.

```json theme={null}
{
  "tool": "stop_performance",
  "arguments": {}
}
```