# Finding your way around

This page covers the sidebar, moving through a long conversation, following
an agent's tasks and subagents, and the home page.

## The sidebar

The sidebar lists your conversations under **Projects**, one folder per
repository. Conversations without a repository are in the **Start from
scratch** folder. **Pinned** sits above the projects when you have pinned
conversations; a pinned conversation appears there and not in its project.

- **Add workspace** (the folder-plus button) adds a repository to
  **Projects** before you have run anything in it. The list is the same as the
  composer's repository picker.
- **View options** sets **Group by** (**Project** or **In one list**) and
  **Order by** (**Last updated** or **Manual**). With **Manual**, drag a project
  or a conversation to a new place, or press **Alt+↑** / **Alt+↓** on a focused
  row. The order changes only how the list is shown.
- A spinner marks a queued or running conversation, and a blue dot a result
  you have not opened yet. A conversation waiting for your answer or for a tool
  approval says so.

Your grouping, order, expanded projects and added workspaces are remembered
for your account in this browser. So is which results you have read.

### Search

Choose **Search tasks**, or press **⌘K** on a Mac and **Ctrl+K** elsewhere,
while the sidebar is open. Search matches conversation titles and repository
names. **Current project** limits it to the open project, and **Include
archived** adds archived conversations. Use the arrow keys and **Enter** to
open a result, and **Escape** to close search.

### Getting started

Until you have a conversation, **Getting started** in the sidebar shows the
next of three steps: **Connect GitHub**, **Grant a repository** and **Run your
first task**. **Skip** hides it in this browser, and **Show again** in **My
Settings → Getting started** brings it back.

## Moving through a conversation

On a wide enough window with a mouse or trackpad, a rail of marks runs beside
the chat, one mark per turn. Point at a mark, or focus it with **Tab**, to see
that turn's question and the start of the agent's reply. Click it, or press
**Enter**, to jump to the turn. The arrow keys move between marks, and **Home**
and **End** go to the first and the last. On a narrow window or a touch
screen, scroll the conversation as usual.

While the agent works, the chat follows new output. Once you scroll up, it
stays where you are reading, and **Back to bottom** above the composer takes
you back to the end and resumes following. A dot on the button means new
output has arrived.

## Tasks and subagents

When an agent keeps a task list or delegates work to subagents, the **Tasks and
subagents** window shows them for the selected turn; the button in the task
header reopens it after you close it.

- **Tasks** shows the agent's checklist with each item's status.
- **Subagents** shows each delegated agent's assignment, model and latest
  state, and under **Returned to the main agent**, the reply the main agent
  received.

Choose a subagent in the window, or **Switch to subagent ›** on the call that
started it in the chat, to read its own conversation. From there, **View
trajectory ›** opens its steps in **Trajectory**, where **Show steps from**
narrows the steps to one subagent or shows **All agents**. Which agents use
subagents is listed in [Agents and models](models.md#agents).

## The home page

The home page shows your avatar and up to three suggestions for writing clearer
requests.

- **Avatar.** Unless you upload a profile photo in **My Settings**, your
  avatar is a Pokémon companion that stays the same for your account. On the
  home page, its colors and badges show the kinds of work in your 50 most
  recent requests, such as frontend, testing or security. They are worked out
  each time you open the page: nothing is stored, and your
  [memory](tools.md#memory) settings do not affect them.
- **Suggestions** point out what your recent requests tend to leave out, such
  as how to check that a change works, or the steps to reproduce a failure.

## Keyboard shortcuts

| Keys | What they do |
|---|---|
| **⌘K** / **Ctrl+K** | Search conversations |
| **⌘J** / **Ctrl+J** | Open or close the workspace pane |
| **Enter** / **Shift+Enter** | Send the message / add a new line |
| **⌘Enter** / **Ctrl+Enter** | Steer the running turn (Claude Code and Codex) |
| **Escape** | Stop the running turn, when the focus is not in a text field |
| **Alt+↑** / **Alt+↓** | Move the focused sidebar row, in **Manual** order |