Organize your conversations
Use projects and the left sidebar to keep track of ongoing work. A session is a conversation about a repository or task; sub-sessions appear nested under the main conversation.
Group related work in projects
Projects group related work together. Use a project to organize conversations for the same repository or task. For cloud repositories and project setup, see the shared Projects guide.
Return to the main conversation to follow the overall task; select a nested sub-session to inspect its independent work. Panel contents belong to the selected conversation, not the whole project; see Select the right conversation.
Pin a session
- Hover over a session's name in the sidebar.
- Click the pin button, on the left of the two hover controls. The archive button is on its right.
- The session moves into Pinned, above Projects and below the sidebar's feature entries.
Pinning changes where the session appears, making it easier to return to. Its nested sub-sessions remain visible beneath it in the sidebar.
Archive a session or sub-session
- Session: hover over its name and click the archive button, on the right of the pin button.
- Sub-session: hover over its nested name and click its archive button.
Use archiving to organize the sidebar when a conversation is no longer part of your active work. Archiving is not a Git operation: it should not be used as a substitute for reviewing, committing, or delivering changes in the repository.
On macOS, hold Cmd to see the numbered session shortcuts in the sidebar, then press a number from 1 to 9 to switch to that conversation: Cmd+1 opens the first numbered conversation, Cmd+2 the second, and so on.
The numbering follows the sidebar from top to bottom, including nested sub-sessions. For example, a pinned main session can be 1, its sub-sessions 2–4, and conversations in Projects 5–9. Use the numbers currently displayed rather than assuming a conversation always has the same shortcut after the list changes.
For other navigation and actions, use the command palette.
Command palette
On macOS, press Cmd+K to open the command palette. Type in Start typing… to find an action, or use the Up and Down arrow keys to move through the list.
The palette groups actions by area:
| Group | Available actions |
|---|---|
| Chats | New session. |
| Session | Session actions for the current conversation. |
| Meeting notes | Start recording. |
| Modes | Switch to Work or Code. |
| Context | Open My connectors or Instructions. |
| Extensions | Go to Extensions. |
| Settings | Change theme, Log out, adjust or reset font size, and Open settings. |
| View | Toggle sidebar, Go back, and Toggle Panels. |
| Window | Close window, Reload, and Force reload. |
| Actions | Open Keyboard shortcuts. |
Actions with a keyboard shortcut show it on the right. For example, the macOS palette shows Cmd+N for New session, Cmd+B for Toggle sidebar, Cmd+J for Toggle Panels, and Cmd+, for Open settings. Consult Keyboard shortcuts for the full list shown by your app rather than assuming shortcuts are identical across keyboard layouts and operating systems.
On macOS, use Shift+Cmd+1 to switch to Work and Shift+Cmd+2 to switch to Code. These shortcuts switch modes, not conversations.
Return to active work
Start your next coding task, follow its progress, or review a completed change. Use parallel tasks when work needs separate checkouts or delegated conversations.