Availability
Sidebar structure
From top to bottom:- Top: New chat and the Search chats magnifier.
- Pinned: sessions you pinned. Not shown when there are none.
- Cloud projects: projects imported from GitHub, created in the cloud, or uploaded to the cloud, with their sessions underneath.
- Local projects: projects from folders on your computers, with their sessions underneath.
- Recents: sessions not in any project, sorted by most recent activity.
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. PressEsc 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.
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.
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.