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

> List, rename, and delete saved Braintrust login profiles from the CLI.

`bt profiles` manages saved Braintrust login profiles. A profile stores local login metadata and credentials for one Braintrust app URL. Organization and project context are selected separately with [`bt switch`](/docs/reference/cli/switch).

Use [`bt status --all`](/docs/reference/cli/status) when you need to verify whether saved profiles still have valid credentials.

Deleting a profile removes local profile metadata and stored credentials. It does not revoke API keys or sign you out of the Braintrust web app.

When you rename a profile, `bt` updates references to it in the global `~/.config/bt/config.json` file (or `$XDG_CONFIG_HOME/bt/config.json`) and the active local `.bt/config.json` file for the current directory. Deleting a profile clears those references.

## Subcommands

| Subcommand                             | Description                                                                                 |
| -------------------------------------- | ------------------------------------------------------------------------------------------- |
| `bt profiles`                          | List saved profiles                                                                         |
| `bt profiles list`                     | List saved profiles                                                                         |
| `bt profiles delete [name]`            | Delete a saved profile and its credentials. Omit the name to choose a profile interactively |
| `bt profiles rename <name> <new-name>` | Rename a saved profile and move its stored credentials                                      |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
bt profiles
bt profiles list --json
bt profiles delete test-profile
bt profiles rename test-profile renamed-profile
```

## Flags

| Command              | Flag            | Description                                                                      |
| -------------------- | --------------- | -------------------------------------------------------------------------------- |
| `bt profiles delete` | `--force`, `-f` | Skip confirmation. Requires a positional profile name or an explicit `--profile` |

`bt profiles` accepts shared [global flags](/docs/reference/cli/overview#global-flags), including `--json` and `--profile`. `--json` works with every subcommand.