getting started

Up and running in a few minutes.

Brett is a coding agent that lives in your terminal and picks the right model for every task automatically. Here's everything you need to start.

1

Install Brett

You'll need Node.js 18 or newer. Then install from npm:

$ npm install -g brettai

Don't have Node? Install it first — winget install OpenJS.NodeJS on Windows, or grab it from nodejs.org. Reopen your terminal afterward.

Windows users — one extra step

Windows blocks npm scripts by default. Run this once in your PowerShell session before installing:

$ Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
2

Create your account

Sign up on the dashboard. Your team and workspace are created automatically.

Sign up →

New accounts start empty. Once you've signed up, send us your account email and we'll add starting credits so you can begin right away.

3

Log in from the terminal

Use the same email and password you just signed up with:

$ brett login

Your login is saved, so you only do this once per machine.

4

Start building

Go to any project folder and launch Brett:

$ cd your-project
$ brett

Just type what you want in plain English. Brett reads your code, proposes changes as diffs you approve with y, and runs commands when you let it.

A few things to know

You never pick a model

Brett routes each task to the right tier automatically — cheap and fast for routine work, stronger models for hard problems. For a genuinely tough task, type /max to force the most capable model.

Mention files with @

Type @src/auth.ts to pull a file into the conversation so Brett can see it.

Plan before building

Type /plan and Brett asks questions to scope a feature before writing code. /build hands the plan to the coder.

Track spend on the dashboard

The usage pageshows exactly what you've spent and how much Brett saved by routing intelligently.

Stuck? Found a bug?

This is an early release and your feedback shapes it directly. If something breaks, feels confusing, or you wish it worked differently — tell us. The rough edges you hit are exactly what we want to hear about.

support@choosebrett.com