> ## Documentation Index
> Fetch the complete documentation index at: https://braintrust.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# bt experiments

> List, view, compare, and delete Braintrust experiments from the CLI

`bt experiments` manages [Braintrust experiments](/evaluate/run-evaluations) directly from the CLI.

## Subcommands

| Subcommand                                      | Description                                                            |
| ----------------------------------------------- | ---------------------------------------------------------------------- |
| `bt experiments list`                           | List all experiments in the current project                            |
| `bt experiments view <name>`                    | Display experiment metadata (use `compare` for summary metrics)        |
| `bt experiments compare <base> <comparison>...` | Compare summary metrics for up to eight experiments (alias: `summary`) |
| `bt experiments delete <name>`                  | Delete an experiment                                                   |

## bt experiments list

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
bt experiments list
```

Lists all experiments in the current project.

## bt experiments view

Display an experiment's metadata, including description, creation time, commit, dataset, visibility, and tags, along with a link to view results in the browser. To compare summary metrics across experiments, use [`bt experiments compare`](#bt-experiments-compare).

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
# View by name
bt experiments view my-experiment

# Open the experiment in your browser instead
bt experiments view my-experiment --web
```

### Flags

| Flag                  | Description                                              |
| --------------------- | -------------------------------------------------------- |
| `--name`, `-n <NAME>` | Experiment name (alternative to the positional argument) |
| `--web`               | Open the experiment in your browser                      |

## bt experiments compare

Compare summary metrics for up to eight experiments side by side: one base experiment and up to seven comparisons. Pass experiment names, or a Braintrust experiment comparison URL copied from the app.

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
# Compare a base experiment against one or more comparisons
bt experiments compare baseline challenger-a challenger-b

# Use flags instead of positional arguments
bt experiments compare --base baseline --comparison challenger-a -c challenger-b

# Compare from a Braintrust comparison URL
bt experiments compare 'https://www.braintrust.dev/app/my-org/p/my-project/experiments/baseline?c=challenger'

# Include rows for metrics with zero or no change
bt experiments compare baseline challenger-a --all
```

### Flags

| Flag                        | Description                                                                    |
| --------------------------- | ------------------------------------------------------------------------------ |
| `--base <NAME>`             | Base experiment name (alternative to the first positional argument)            |
| `--comparison`, `-c <NAME>` | Comparison experiment name. Pass multiple times to compare several experiments |
| `--url <URL>`               | Braintrust experiment comparison URL                                           |
| `--all`                     | Include rows for metrics with zero or no change                                |

## bt experiments delete

Delete an experiment and its results.

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
# Delete by name
bt experiments delete my-experiment

# Skip the confirmation prompt
bt experiments delete my-experiment --force
```

### Flags

| Flag                  | Description                                              |
| --------------------- | -------------------------------------------------------- |
| `--name`, `-n <NAME>` | Experiment name (alternative to the positional argument) |
| `--force`, `-f`       | Skip the confirmation prompt                             |