# The guide

After your first sign-in, a five-step guide helps you make your first hats, check your assistants, add a first item and find your way around. You can leave it at any step and open it again later.

The first time you sign in with a new account, the app opens a guide before the main screen. It has five steps. Brim stands on the left and says a line about the step. The step itself is on the right.

![The first step of the guide, with a field for what you juggle and the hats the app suggests](/docs/assets/guide-juggle.webp "The first step of the guide.")

A row of five bars sits at the top of the card, with a short name under each: **What you juggle**, **Your hats**, **Assistants**, **A first item** and **Where things are**. A check on a bar means you finished the step. A dash means you skipped it. Press any bar to open that step.

## The five steps

### 1. What you juggle

Brim says "Tell me what you work across." Under **What do you juggle?**, type a few words about the companies, projects or parts of life you work across. For example: `Acme Studio, my podcast, home`.

Under the field, **Hats I'll suggest** lists one hat for each name. The app splits your words at commas, semicolons, slashes and line breaks. A piece of up to four words becomes a hat with that name. A longer piece reads as a sentence and gives no hat, and the field says "Write each one as a short name, with commas between them." There are never more than six.

Press **Continue**.

### 2. Your first hats

Brim says "Each hat keeps its own work." The step shows one row for each suggested hat, with a color on the left and the name in a field.

- Press the color to pick another one.
- Change a name by typing in its field.
- Press the **x** to remove a row.
- Press **Add another hat** for a new row.

If your words gave no hat, or you skipped the first step, the rows start as **Work**, **Home** and **Side project**, with the line "A start to rename. Change any name, remove a row or add your own."

If a name is the same as a hat you already have, or appears in two rows, a quiet line under the row says so. The hat is still made with that name.

Press the button at the bottom, which counts the rows: **Make 3 hats**, or **Make 1 hat**. Each row then says **Made**, and the app says "3 hats made. They're in your list of hats." If a hat could not be made, its row says why, and the button reads **Try the 1 that failed**.

If you already have hats, for example when you open the guide again later, the step is called **Add to your hats** and shows them under **You have**. Its rows are for more hats, and you can add none.

[Your hats](/docs/app-window/hats.md) covers colors, including any color you pick yourself.

### 3. Your assistants

Brim says "I work through your own assistant." The step lists Claude Code, Codex and OpenCode, with the same cards as the [Assistants](/docs/app-window/assistants.md) screen: whether each was found on this computer, which one is in use, and what to do about one that is not ready. After you install or sign in to an assistant, press **Check again**.

If none is ready, the app says "You can go on without one". You can finish the guide and make hats. A conversation waits until an assistant is ready.

### 4. A first item

Brim says "Give me something to hold for you." Choose a **Kind**: **To do**, **To send** or **Waiting**. Type a **Title**, such as "Send the March invoice", and choose the **Hat**. For **Waiting**, **Who owes it** asks who you are waiting on.

Press **Add to the queue**. The app says `"Send the March invoice" is under Acme Studio.` and which tab of the queue holds it, with **Add another** and **Continue**. If you come back to this step later, it shows the same item. If you have no hat yet, the step says "Items sit under a hat, and you have none yet." and offers **Make a hat first**.

![The fourth step after an item was added, with the line "The signed contract" is under Bakery](/docs/assets/guide-first-item.png "The first item is in the queue.")

[Your queue](/docs/app-window/queue.md) explains the three kinds.

### 5. Where things are

Brim says "Here's where everything lives." A small map of the main screen lights up four places one at a time: **Hats**, **Queue**, **Brim** and **Account**. Press **Next** to go on, or press a place on the map. Under the map, **Coming later** says that mail, calendar and Slack connectors, packs of skills, and usage limits for your AI accounts are on the way and that this version does not have them yet.

![The last step of the guide, with a map of the main screen and the Coming later note](/docs/assets/guide-where-things-are.png "The last step.")

On the last place, the button reads **Open my hats**. It opens the main screen. If you added an item in step 4, the queue opens on its tab with that item selected.

## Skip a step, or leave

- **Skip this step** moves on without doing the step. The bar shows a dash, and you can come back to it. A step you finished has no **Skip this step**, and stays finished.
- **Back** goes to the step before. It appears from step 2 on.
- **Leave the guide** puts the guide away and opens the main screen. Steps you skipped stay skipped. The Escape key does nothing in the guide, so a stray key press never closes it.

## If you close the app halfway

The app keeps your progress on this computer, for your account. When you open the app again, the guide comes back on the first step you have not finished or skipped, and the words you typed in the first step are still there.

If you left the guide before making a hat, the main screen says **Start with your first hat** and offers **Open the guide** next to **New hat**.

![The main screen of an account with no hats, with the buttons New hat and Open the guide](/docs/assets/no-hats-yet.png "Open the guide, on a screen with no hats.")

## Open the guide again

Press the three dots beside your email at the top left and choose **Guide**. It opens on step 1 with your progress marked. An account that already has hats does not get the guide by itself, so the menu is where to find it.

Next, [make a hat on your own](/docs/get-started/first-hat.md) or [ask Brim a question](/docs/get-started/first-question.md).
