Skip to main content
The sidebar is the session list on the left of Cloud Tasks pages. You use it to find, open, and organize your sessions and projects. Each session appears only once in the sidebar: sessions in a project appear under that project, sessions not in any project appear in Recents, and pinned sessions appear in Pinned.

Availability

From top to bottom:
  1. Top: New chat and the Search chats magnifier.
  2. Pinned: sessions you pinned. Not shown when there are none.
  3. Cloud projects: projects imported from GitHub, created in the cloud, or uploaded to the cloud, with their sessions underneath.
  4. Local projects: projects from folders on your computers, with their sessions underneath.
  5. Recents: sessions not in any project, sorted by most recent activity.
You can click each group header to collapse or expand it, and the state persists after you reopen the app.

Cloud projects and local projects

Projects are grouped by source, regardless of where they run now: a project from a folder on your computer always stays in Local projects, even after it moves to the cloud. All other projects are in Cloud projects.
  • Hover a section header and + appears on the right for creating a project. When the section is empty, it shows the Import from GitHub or Add a local folder entry. See Projects.
  • Local projects shows local projects from all your computers. On the web app you can only view them and start sessions in them; sessions run on the computer where the project is.
  • Without Plus, Import from GitHub is marked Needs server, and clicking it first opens the Plus subscription dialog. See Plus plan.

Project rows

  • Click the folder icon to expand or collapse the project’s sessions; click the project name to open the project detail page. When there are many sessions, the rest are under Show more.
  • When you hover a project row, the pin button, Project actions (…), and New task in this project appear on the right. On mobile web, New task in this project is always visible, and you long-press the project name to open the project menu.
  • Pinned projects always stay at the top of their section.

Child sessions

Child sessions sent out by the agent are nested under the parent session. The parent row shows the number of child sessions; click the number to expand or collapse them. Finished child sessions are collapsed into a single row, N completed. Sessions created by forking or with New chat in this worktree are not child sessions.

Pending sessions without Plus

Without Plus, messages you send are stopped, and the session is saved only on this device. It appears as a row in the sidebar, and its menu has only Delete (cannot be recovered). After you get Plus, the message is sent automatically and the row becomes a normal session.

Session status

Status at the end of a session row

The right end of a session row shows only one status at a time, in this priority order from highest to lowest:
  • If sending a message fails, the session row shows Not sent.
  • When a group, section, project, or Show more is collapsed, the hidden sessions are summarized as one status, the highest priority one, shown to the right of the header. After you expand, each row shows its own status.

Mark as read

  • Press ⇧Esc (Windows: Shift+Esc) to mark all unread sessions as read at once.
  • Use Mark as read / Mark as unread in a session’s … menu one at a time.

Dragging

In the desktop app and the web app, you can drag projects and sessions in the sidebar directly. Press Esc during a drag to cancel. Dragging is not supported on mobile web.

Drag projects: reorder

Press and hold a project row, drag it to the target position, and release to finish reordering.
  • You can only reorder within the same section.
  • Pinned projects always stay above unpinned ones, and the two cannot swap places.
  • In the one-list view you cannot drag projects.

Drag sessions: file into a project or move back to Recents

Drag a session onto a project and release to file it into that project; drag it onto Recents to move it out of the project. Hold over a collapsed group or project briefly and it expands automatically. You cannot reorder sessions within a project. Other limits:
  • Child sessions move together with their parent and cannot be dragged on their own.
  • While a project is still being set up, or when the project is on another computer, you cannot move sessions into or out of it. A message explains why.
  • You can also drag a session row into the conversation area to open split view. See Split view.
Why moves between projects only change the grouping: each project corresponds to a repository and a run environment, and the session has already changed code on the original project’s branch. Changing only the grouping lets you organize the sidebar freely without affecting the session itself.

Move to project… menu

When dragging is inconvenient, choose Move to project… in a session’s … menu. The rules are the same as for dragging: you can search projects, and projects you cannot move to are grayed out with the reason. Sessions already in a project have an extra item, Move to Recents, and New project is at the end.

Organize the sidebar

Hover the Cloud projects header and click … (Organize and sort) on the right › Organize sidebar:
  • By project (default): shows the groups described above.
  • In one list: puts all sessions into one Recents list, with each row showing its project.
This choice and the manual project order are saved with your account.

Session … menu

Hover a session row and click …, right-click a session row in the desktop app, or long-press a session row on mobile web to open the session menu. Chat actions (…) in the session page top bar is the same menu. For the shortcut for each item, see Keyboard shortcuts. On the web app, holding ⌘ (Windows: Ctrl) while clicking a session row opens it in a new tab. Holding ⌥ (Windows: Alt) while clicking adds it to split view.

Project … menu

Hover a project row and click … (Project actions), right-click a project row in the desktop app, or long-press the project name on mobile web:

Info cards

In the desktop app and desktop browsers, hold the mouse over a session row or project row briefly and an info card pops up:
  • Session info card: title, time since last activity, project and source, and current status.
  • Project info card: project name, number of sessions, source (GitHub repository or local folder), cloud server status, and Edit project. For local projects on other computers, it states which computer new tasks run on.

Archive

Archiving removes a session from the sidebar but keeps its history, and you can restore it later.
  • Entry points: Archive in the session … menu, the shortcut ⇧⌘A (Windows: Ctrl+Shift+A), and Archive chats in the project … menu (for the whole project).
  • You can click Undo on the toast after archiving.
  • View, restore, or permanently delete archived sessions in Settings › Archived chats. See Archived chats.

Search chats

Click the magnifier at the top of the sidebar, or press ⌘K (Windows: Ctrl+K), to search by session title and project name. ⏎ opens the first result, and Esc closes the search.

Collapse the sidebar

  • Desktop app: click the sidebar toggle in the left section of the top bar, or press ⌘\ / ⌘B (Windows: Ctrl+\ / Ctrl+B).
  • Web app: click Hide sidebar at the top left of the sidebar. When collapsed, Show sidebar and New chat appear at the top left of the main area. The shortcuts are the same.
  • Mobile web: tap Open menu at the top left of the main area or swipe right from the left edge of the screen to open it; swipe left or tap the overlay to close it. The bottom of the drawer has the Projects, Activity, Scheduled tasks, and Cloud server entries and your account.

FAQ

Why isn’t my session in Recents?

Recents contains only sessions that are not in any project. Sessions in a project appear under that project, and pinned sessions appear only in Pinned. You can press ⌘K to search.

After I drag a session to another project, does it run in the new project?

No. Moving a session that is already in a project to another project in the same section only changes the sidebar grouping, and it continues in the original project’s working directory and branch. Only when you move a session from Recents into a project do later messages run in that project, and that step cannot be undone.

Can the web app see my local projects?

Yes. The web app also shows Local projects and its sessions, but you cannot add local folders on the web. Sessions created in a local project run on the computer where the project is.

What does Needs input next to a collapsed project mean?

At least one session hidden in that collapsed project is waiting for you to approve, answer, or take action. Expand the project to see which one.