> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braintrust.dev/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](https://docs.braintrust.dev/evaluate/run-evaluations.md) directly from the CLI. Running `bt experiments` without a subcommand is equivalent to running `bt experiments list`.

## 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. If you omit the experiment name in an interactive terminal, `bt` prompts you to select one. 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. If you omit the experiment name in an interactive terminal, `bt` prompts you to select one.

```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. Requires an experiment name |

Use the shared [`--org`, `--project`, and `--profile` global flags](https://docs.braintrust.dev/reference/cli/overview#global-flags) to select the Braintrust context. The `list`, `view`, and `compare` subcommands also support `--json` output.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.