> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ve.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Ve is a desktop browser for macOS. Steps on these pages are carried out inside Ve itself, not on a website, and there is no web version.
> Settings paths are written as `Settings > Section`.

# Tabs, the sidebar and the command bar

> Tabs run along the top, the sidebar on the left is a launcher, and the command bar searches your open tabs and history.

Tabs run along the top of the window. The sidebar down the left holds your
profile, your mail and your chats. The command bar opens over the page when you
are looking for something you already had open.

## Tabs

Tabs sit in a horizontal strip at the top of the window and stay there. Ve has
no vertical tabs mode, and no setting moves the strip into the sidebar.

### Switching with the keyboard

Hold <kbd>Control</kbd> and tap <kbd>Tab</kbd>. A filmstrip of your open tabs
appears, ordered by the ones you used most recently.

| Key                                                    | Does                           |
| ------------------------------------------------------ | ------------------------------ |
| <kbd>Control</kbd> + <kbd>Tab</kbd>                    | Move forward through the strip |
| <kbd>Control</kbd> + <kbd>Shift</kbd> + <kbd>Tab</kbd> | Move backward                  |
| Release <kbd>Control</kbd>                             | Switch to the highlighted tab  |
| <kbd>Esc</kbd>                                         | Cancel and stay where you are  |

### What a new tab shows

A new tab opens on one field with a **Search** and **Ask Ve** toggle under it.
Press <kbd>Tab</kbd> to move between the two modes.

| Mode   | What Enter does                                                                |
| ------ | ------------------------------------------------------------------------------ |
| Search | Opens the address if what you typed looks like one, otherwise searches the web |
| Ask Ve | Opens the full chat page with your prompt already sent                         |

In Search mode Ve offers suggestions as you type. Arrow keys move through them,
and <kbd>Esc</kbd> dismisses the list.

In Ask Ve mode the bar grows a **+** for attaching files and pickers for the
provider, model and reasoning effort. Files you attach stay on the new tab as
chips until you send. <kbd>Shift</kbd> + <kbd>Enter</kbd> adds a line break
instead of sending.

<Note>
  Ask Ve needs a connected model. See [Connect a model](/connect-a-model).
</Note>

## The sidebar

The sidebar is a launcher, not a tab list. Your tabs are never in it. It carries
your profile, what Ve has picked up for today, and the pages inside Ve you keep
going back to.

The button at the top right of the sidebar hides it. Once hidden, a **Show
sidebar** button appears at the far left of the toolbar to bring it back. Only
one of the two is ever on screen.

### The header

| Control              | Does                                                    |
| -------------------- | ------------------------------------------------------- |
| Your name and avatar | Opens the profile menu                                  |
| Magnifier            | Opens the command bar                                   |
| **Update**           | Appears only when an update is waiting, and installs it |

### The profile menu

Clicking your avatar opens a menu with your current profile at the top and any
other profiles below it, so you can switch between them.

Under that, four actions:

| Action          | Does                             |
| --------------- | -------------------------------- |
| New tab         | Opens a tab                      |
| Incognito       | Opens an incognito window        |
| Manage profiles | Opens Chromium's profile manager |
| Settings        | Opens Ve's settings              |

Then five rows that open a panel beside the menu when you hover or click them:
Bookmark, Download, Extensions, History and Developers.

### Workspace and Threads

One row under **Workspace**:

| Row    | Opens                  |
| ------ | ---------------------- |
| Memory | Your files and folders |

Under **Threads**, **Recent chats** expands into your chat history. The list
merges chats you started in Ve with your ChatGPT history, read from the
chatgpt.com session you are already signed into. Pinned chats sit at the top.

Hover a chat for two buttons: pin it, or delete it. Chats started in Ve's own
panel can be deleted but not pinned. The **+** in the section header starts a
fresh chat.

### Things you need to know

A card at the top of the sidebar shows your next meeting and a short row of
suggested actions. A meeting that has already started reads **Happening now**
rather than **Upcoming**, and carries a **Join** button when Ve can find a real
meeting link.

The card hides itself when there is no meeting and no suggestion.

### When the sidebar is collapsed

A small pill of icons takes its place next to the toolbar: the Ve spark, which
floats the same "Things you need to know" card as a popup, your avatar for the
profile menu, a Mission Control chip and a shortcut to Memory.

The Mission Control chip does nothing yet.

## The command bar

Click the magnifier in the sidebar header. <kbd>Command</kbd> + <kbd>K</kbd>
does the same thing while the sidebar has keyboard focus.

The bar opens centred over the page, not inside the sidebar, with a field
reading "Search tabs, history…" and three sections below it.

| Section         | Holds                                                              |
| --------------- | ------------------------------------------------------------------ |
| Open tabs       | Every tab in this window, with the current one marked "Active tab" |
| Recently closed | Tabs, windows and groups you can put back                          |
| Recent history  | Pages you visited, most recent first                               |

Typing filters all three at once. Arrow keys move the selection,
<kbd>Enter</kbd> opens it, and <kbd>Esc</kbd> closes the bar.

## Related

* [Keyboard shortcuts](/shortcuts)
* [Chat with Ve](/chat)
* [Make Ve your default browser](/default-browser)
