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

> Set the default Braintrust organization and project for bt commands in a directory.

`bt init` saves a default Braintrust organization and existing project for the current directory in `.bt/config.json`. Project-scoped `bt` commands run from that directory or its subdirectories use this local context unless you override it with command-line options or environment variables.

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
bt init
bt init --org acme --project my-app
```

For example, after the second command, the following commands use the `acme/my-app` project by default:

```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
bt datasets list
bt prompts list
bt experiments list
bt scorers list
bt view logs
```

`bt init` does not create a Braintrust project or instrument your application. In an interactive terminal, it prompts you to select a profile, organization, and project when needed. In a non-interactive environment, pass `--org` and `--project`; also pass `--profile` if `bt` cannot select one unambiguously.

To change the saved context later, use [`bt switch --local`](/docs/reference/cli/switch).

## Flags

`bt init` uses the shared [global flags](/docs/reference/cli/overview#global-flags), including `--org`, `--project`, `--profile`, and `--json`.