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

> Manage Braintrust prompts, versions, and environment assignments from the CLI.

`bt prompts` manages prompts in the active Braintrust project. You can inspect prompt versions and assign a specific version to a [deployment environment](https://docs.braintrust.dev/deploy/environments.md).

## Subcommands

| Subcommand | Description |
| - | - |
| `bt prompts` | List prompts in the active project |
| `bt prompts list` | List prompts in the active project |
| `bt prompts view [slug]` | View a prompt. Omit the slug to choose a prompt interactively |
| `bt prompts versions [slug]` | List the versions of a prompt. Omit the slug to choose a prompt interactively |
| `bt prompts assign <slug>` | Assign a prompt version to an environment |
| `bt prompts unassign <slug>` | Remove a prompt from an environment |
| `bt prompts delete [slug]` | Delete a prompt. Omit the slug to choose a prompt interactively |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
bt prompts list
bt prompts view my-prompt
bt prompts versions my-prompt
bt prompts assign my-prompt --version 1234 --environment production
bt prompts view my-prompt --environment production
bt prompts unassign my-prompt --environment production
bt prompts delete my-prompt
```

Use `bt prompts versions` to find a prompt version ID. Both short and decimal transaction IDs are accepted. Pass `--environment` to `bt prompts list` or `bt prompts view` to inspect the version assigned to an environment.

## Command-specific flags

| Command | Flag | Description |
| - | - | - |
| `bt prompts list` | `--environment <SLUG>` | List the prompt versions assigned to an environment |
| `bt prompts view` | `--slug`, `-s <SLUG>` | Prompt slug (alternative to the positional argument) |
| `bt prompts view` | `--version <VERSION>` | View a specific prompt version. Cannot be used with `--environment` |
| `bt prompts view` | `--environment <SLUG>` | View the prompt version assigned to an environment. Cannot be used with `--version` |
| `bt prompts view` | `--web` | Open the prompt in your browser instead of showing it in the terminal |
| `bt prompts versions` | `--slug`, `-s <SLUG>` | Prompt slug (alternative to the positional argument) |
| `bt prompts assign` | `--slug`, `-s <SLUG>` | Prompt slug (alternative to the positional argument) |
| `bt prompts assign` | `--version <VERSION>` | Prompt version to assign. Required |
| `bt prompts assign` | `--environment <SLUG>` | Environment to assign the prompt version to. Required |
| `bt prompts unassign` | `--slug`, `-s <SLUG>` | Prompt slug (alternative to the positional argument) |
| `bt prompts unassign` | `--environment <SLUG>` | Environment to remove the prompt from. Required |
| `bt prompts delete` | `--slug`, `-s <SLUG>` | Prompt slug (alternative to the positional argument) |
| `bt prompts delete` | `--force`, `-f` | Skip the confirmation prompt. Requires a prompt slug |

`bt prompts` accepts shared [global flags](https://docs.braintrust.dev/reference/cli/overview.md#global-flags), including `--org`, `--project`, and `--profile`. Use `--json` with `bt prompts`, `bt prompts list`, `bt prompts view`, `bt prompts versions`, `bt prompts assign`, or `bt prompts unassign` for machine-readable output. Use `--verbose` with `bt prompts view` to include the prompt's options.


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