# Multiple accounts
Source: https://docs.withbrevity.email/features/accounts

Use multiple Gmail accounts

Brevity supports multiple Gmail accounts. Each account has its own inbox, drafts, sent folder, and local database.

## Adding an account

Click the account switcher in the bottom-left sidebar and select **Add account**. Sign in with another Gmail account.

## Switching accounts

Click the account switcher to select an account, or use keyboard shortcuts:

| Shortcut                | Action                      |
| ----------------------- | --------------------------- |
| `Cmd+1`                 | First account               |
| `Cmd+2`                 | Second account              |
| `Cmd+3` through `Cmd+9` | Third through ninth account |

Each account's data is fully separate — tabs, workflows, and snippets are per-account.


# Chat
Source: https://docs.withbrevity.email/features/chat

Ask the AI to help with your email

Press `?` to open Chat, or navigate via the sidebar.

## Open in Chat

Press `Cmd+/` while viewing or hovering over a thread to open it directly in Chat. The thread content is attached as context so the agent can read and reason about it. You can also use the **Open in Chat** action from the command palette (`Cmd+K`).

The thread appears as a compact card near the input. Once you send your first message, it moves to a banner at the top of the conversation.

## What the agent can do

The Brevity Agent can:

* Search your emails
* Draft and send replies
* Archive threads
* Query your email database
* Add labels

By default, the agent asks for confirmation before taking actions.

## AI tiers

Choose the tier that fits the task:

| Tier                   | Best for                  |
| ---------------------- | ------------------------- |
| **Brevity Agent Max**  | Complex, multi-step tasks |
| **Brevity Agent**      | General-purpose (default) |
| **Brevity Agent Lite** | Quick, simple requests    |

## New conversations

Press `Cmd+N` while on the Chat page to start a fresh conversation.


# Compose
Source: https://docs.withbrevity.email/features/compose

Write and send email

## New email

Press `C` to compose a new email. Fill in the To, CC, and BCC fields. Brevity suggests contacts as you type.

## Send

| Shortcut          | Action                      |
| ----------------- | --------------------------- |
| `Cmd+Enter`       | Send                        |
| `Cmd+Shift+Enter` | Send and archive the thread |

## Reply and forward

Open a thread and use the reply controls at the bottom, or press `F` to forward.

## More shortcuts

| Shortcut      | Action                                 |
| ------------- | -------------------------------------- |
| `Cmd+Shift+P` | Pop out composer into its own window   |
| `Cmd+;`       | Insert a [snippet](/features/snippets) |
| `Cmd+Shift+,` | Discard draft                          |

<Tip>
  **Send and archive** (`Cmd+Shift+Enter`) is the fastest way to reply and move on. It sends your reply and removes the thread from your inbox in one step.
</Tip>


# Handoff
Source: https://docs.withbrevity.email/features/handoff

Delegate email threads to the AI

Open the command palette and select **Hand off to AI** to delegate a thread to the AI agent.

## Writing style

The first time you use handoff, Brevity prompts you to set a writing style. The AI uses this to match your tone in drafts.

## Entering an instruction

Describe what you want done — for example, "politely decline this meeting" or "ask for an update on the project timeline."

Choose a review mode:

* **Ask before send** (default) — the AI drafts a response for your review
* **Send without review** — the AI sends and archives automatically

## Reviewing a draft

In **Ask before send** mode, the AI shows a proposed draft. You have three options:

* **Send** — send the draft as-is
* **Edit** — modify the draft before sending
* **Discard** — cancel the handoff

## Auto mode

In **Send without review** mode, the AI sends the response and archives the thread automatically. A notification confirms the action — click **View chat** to see the AI's reasoning.

## What the AI can do

The AI can:

* Reply, forward, or compose new emails
* Archive threads
* Add labels
* Search your emails for context


# Inbox
Source: https://docs.withbrevity.email/features/inbox

Navigate your email

## Sidebar views

The sidebar shows all your email views:

| View           | Go-to shortcut |
| -------------- | -------------- |
| Inbox          | `G I`          |
| Sent           | `G T`          |
| Drafts         | `G D`          |
| Done (Archive) | `G E`          |
| Trash          | `G #`          |
| Spam           | `G !`          |
| Reminders      | `G H`          |
| Workflows      | `G W`          |
| Snippets       | `G ;`          |

Press `?` to open Chat.

## Navigating threads

| Shortcut    | Action             |
| ----------- | ------------------ |
| `J` or `↓`  | Next thread        |
| `K` or `↑`  | Previous thread    |
| `Enter`     | Open thread        |
| `Escape`    | Go back            |
| `Tab`       | Next inbox tab     |
| `Shift+Tab` | Previous inbox tab |

## Command palette

Press `Cmd+K` to open the command palette. Type any action to find and execute it.


# Reminders
Source: https://docs.withbrevity.email/features/reminders

Follow up on important threads

Set a reminder on any thread to bring it back to your attention later.

## Setting a reminder

Click the **bell icon** on a thread to set a reminder. Choose a time:

* Later today
* Tomorrow
* A custom date and time

## Viewing reminders

Navigate to Reminders with `G H` or via the sidebar. Reminders are sorted by time, soonest first.

When a reminder fires, the thread appears in your Reminders view.


# Search
Source: https://docs.withbrevity.email/features/search

Find any email

Press `/` to open search.

## Search prefixes

Narrow your search with prefixes:

| Prefix     | Searches by  |
| ---------- | ------------ |
| `from:`    | Sender       |
| `to:`      | Recipient    |
| `subject:` | Subject line |
| `body:`    | Message body |

Combine prefixes: `from:alice@example.com subject:invoice`

## Suggestions

As you type, Brevity shows recent searches and top contacts. Select a suggestion to search instantly.

## How it works

Brevity searches your local cache first for fast results, then queries Gmail for anything not yet synced.


# Snippets
Source: https://docs.withbrevity.email/features/snippets

Reusable email templates

Snippets are saved blocks of text you can insert while composing.

## Creating a snippet

Navigate to Snippets with `G ;` or via the sidebar. Click **New snippet** and add:

* **Name** — a label to find it later
* **Body** — the template text
* **Subject, To, CC, BCC** — optional pre-filled fields

## Inserting a snippet

While composing an email, press `Cmd+;` to open the snippet picker. Select a snippet to insert it into your draft.

Snippets are sorted by most recently used.


# Split inbox
Source: https://docs.withbrevity.email/features/split-inbox

Organize your inbox with custom tabs

Split inbox divides your inbox into tabs so you can focus on what matters.

## Default tabs

Brevity starts with two tabs: **Important** and **Other**. You can add your own.

## Creating a tab

Click the **+** button next to your inbox tabs. Give it a name and add filter rules.

Each rule matches on:

| Field     | Example              |
| --------- | -------------------- |
| `from`    | Sender email or name |
| `to`      | Recipient email      |
| `subject` | Subject line text    |

Rules support **contains**, **equals**, **starts with**, and **ends with** operators.

## Switching tabs

Press `Tab` to move to the next tab. Press `Shift+Tab` to go back. Each tab shows an unread count.

## Managing tabs

Click the **gear icon** next to your tabs to reorder, edit, or delete them.


# Triage
Source: https://docs.withbrevity.email/features/triage

Process your inbox quickly

## Actions

| Shortcut | Action                            |
| -------- | --------------------------------- |
| `E`      | Archive (mark done)               |
| `S`      | Star or unstar                    |
| `U`      | Mark unread                       |
| `H`      | Mark unread and return to inbox   |
| `X`      | Select thread                     |
| `Cmd+A`  | Select all threads in current tab |
| `Z`      | Undo last action                  |

## Archive

Press `E` to archive a thread. It moves to **Done** and is out of your inbox.

View archived email anytime with `G E`.

## Batch operations

Select multiple threads with `X`, then press `E` to archive them all at once.

<Tip>
  On first launch, Brevity offers **Get Me to Zero** — a bulk archive to clear your inbox down to a clean starting point.
</Tip>


# Workflows
Source: https://docs.withbrevity.email/features/workflows

Automate email handling with AI

Workflows combine filter rules with AI instructions to automatically process incoming email.

## Creating a workflow

Navigate to Workflows with `G W` or via the sidebar. Click **New workflow** and configure:

* **Name** — a label for the workflow
* **Rules** — filter rules that match emails (same as [split inbox](/features/split-inbox) rules: from, to, subject)
* **AI rules** — natural language conditions for the AI to evaluate
* **Instruction** — what the AI should do (e.g., "Draft a polite reply declining the meeting")

## Review mode

Each workflow has a review setting:

* **Ask before send** (default) — the AI drafts a response and waits for your approval
* **Send without review** — the AI sends automatically

## Managing workflows

Toggle workflows on or off without deleting them. Click into a workflow to see all emails it has processed.


# Getting started
Source: https://docs.withbrevity.email/getting-started

Set up Brevity in under a minute

<Steps>
  <Step title="Download Brevity">
    Get Brevity from [withbrevity.email/download](https://withbrevity.email/download). Open the `.dmg` and drag Brevity to Applications.
  </Step>

  <Step title="Sign in with Gmail">
    Open Brevity and sign in with your Google account. Brevity uses OAuth — your password is never stored.
  </Step>

  <Step title="Wait for sync">
    Brevity syncs and caches your email locally. This takes a moment on first launch.
  </Step>

  <Step title="Navigate">
    You're in your inbox. Press `J` and `K` to move between threads. Press `Enter` to open a thread.
  </Step>
</Steps>

<Tip>
  Add more Gmail accounts later from the account switcher in the bottom-left sidebar. See [Multiple accounts](/features/accounts).
</Tip>


# Welcome to Brevity
Source: https://docs.withbrevity.email/index

A keyboard-first email client for Gmail

Brevity is a desktop email app for Gmail, built for speed. It runs on macOS.

<CardGroup>
  <Card title="Get started" icon="rocket" href="/getting-started">
    Set up Brevity in under a minute.
  </Card>

  <Card title="Navigate your inbox" icon="inbox" href="/features/inbox">
    Learn the sidebar, views, and shortcuts.
  </Card>

  <Card title="Triage email" icon="check" href="/features/triage">
    Archive, star, and process your inbox fast.
  </Card>

  <Card title="Keyboard shortcuts" icon="keyboard" href="/reference/keyboard-shortcuts">
    Complete shortcut reference.
  </Card>
</CardGroup>


# Keyboard shortcuts
Source: https://docs.withbrevity.email/reference/keyboard-shortcuts

Complete shortcut reference

## Navigation

| Shortcut    | Action               |
| ----------- | -------------------- |
| `J` / `↓`   | Next thread          |
| `K` / `↑`   | Previous thread      |
| `Enter`     | Open thread          |
| `Escape`    | Go back              |
| `Tab`       | Next inbox tab       |
| `Shift+Tab` | Previous inbox tab   |
| `G I`       | Go to Inbox          |
| `G T`       | Go to Sent           |
| `G D`       | Go to Drafts         |
| `G E`       | Go to Done (Archive) |
| `G #`       | Go to Trash          |
| `G !`       | Go to Spam           |
| `G H`       | Go to Reminders      |
| `G W`       | Go to Workflows      |
| `G ;`       | Go to Snippets       |

## Actions

| Shortcut | Action                        |
| -------- | ----------------------------- |
| `E`      | Archive (mark done)           |
| `S`      | Star / unstar                 |
| `U`      | Mark unread                   |
| `H`      | Mark unread + return to inbox |
| `X`      | Select thread                 |
| `Cmd+A`  | Select all                    |
| `Z`      | Undo                          |
| `F`      | Forward                       |
| `/`      | Search                        |
| `?`      | Open Chat                     |
| `Cmd+/`  | Open thread in Chat           |

## Compose

| Shortcut          | Action           |
| ----------------- | ---------------- |
| `C`               | New email        |
| `Cmd+Enter`       | Send             |
| `Cmd+Shift+Enter` | Send and archive |
| `Cmd+;`           | Insert snippet   |
| `Cmd+Shift+P`     | Pop out composer |
| `Cmd+Shift+,`     | Discard draft    |

## Accounts

| Shortcut                | Action         |
| ----------------------- | -------------- |
| `Cmd+1` through `Cmd+9` | Switch account |

## Global

| Shortcut | Action          |
| -------- | --------------- |
| `Cmd+B`  | Toggle sidebar  |
| `Cmd+K`  | Command palette |