> ## 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 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](/docs/reference/cli/overview#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.
</Warning>