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

> Manage Braintrust projects from the CLI.

`bt projects` manages projects in the active Braintrust organization. Use `--org` to select a different organization for a command.

## Subcommands

| Subcommand | Description |
| - | - |
| `bt projects` | List projects in the active organization |
| `bt projects list` | List projects in the active organization |
| `bt projects create [name]` | Create a project. Omit the name to enter it interactively |
| `bt projects view [name]` | Open a project in the browser, or print its details with `--json`. Omit the name to choose a project interactively |
| `bt projects delete [name]` | Delete a project. Omit the name to choose a project interactively |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
bt projects list
bt projects create my-project
bt projects view my-project
bt projects view my-project --json
```

## Command-specific flags

| Command | Flag | Description |
| - | - | - |
| `bt projects view` | `--name`, `-n <NAME>` | Project name (alternative to the positional argument) |
| `bt projects delete` | `--force`, `-f` | Skip the confirmation prompt. Requires a project name |

`bt projects` accepts shared [global flags](https://docs.braintrust.dev/reference/cli/overview.md#global-flags), including `--org` and `--profile`. Use `--json` with `bt projects` or `bt projects list` for machine-readable output.

With `bt` v0.19.3 or later, `create`, `view`, and `delete` also support `--json`:

* `create` and `view` return a project object. `view --json` does not open a browser.
* `delete` returns a `project` object and a `deleted` boolean. Declining the interactive confirmation returns `deleted: false`.

> [!WARNING]
>
> `bt projects delete` deletes the selected project. The `--json` flag changes the output format, not the operation.


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