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

> Update the bt CLI binary in place.

`bt update` updates the CLI binary in place. It works for installs made with the standalone shell or PowerShell installer.

To update an installed coding-agent tracing integration without changing its tracing settings, use [`bt trace update`](/docs/reference/cli/trace#bt-trace-update).

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
bt update
bt update --check
bt update --channel canary
```

<Note>
  If your installed version does not recognize `bt update`, run `bt self update` once. Versions before v0.16.0 used the older command. After the upgrade, use `bt update`.
</Note>

If `bt` came from the [`braintrust` npm package](/docs/reference/cli/quickstart#install), update that package:

<CodeGroup>
  ```bash npm theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  npm install braintrust@latest
  ```

  ```bash pnpm theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  pnpm add braintrust@latest
  ```
</CodeGroup>

If you installed `bt` with [mise](/docs/reference/cli/quickstart#install), upgrade the configured tool:

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
mise upgrade "github:braintrustdata/bt" --bump
```

If your Windows installation is running `bt` v0.16.x or earlier, update it by rerunning the [PowerShell installer](/docs/reference/cli/quickstart#install). After v0.17.0 is installed, use `bt update` for later updates.

## Flags

| Flag                                     | Description                                   |
| ---------------------------------------- | --------------------------------------------- |
| `--check`                                | Check for updates without installing          |
| `--channel stable` or `--channel canary` | Update channel. Defaults to the build channel |

If GitHub rate-limits an update check, set `GITHUB_TOKEN` in the environment.