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

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

Pin a session

  1. Hover over a session's name in the sidebar.
  2. Click the pin button, on the left of the two hover controls. The archive button is on its right.
  3. 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

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.

Switch sessions with the keyboard

Switch sessions with the keyboard

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

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:

GroupAvailable actions
ChatsNew session.
SessionSession actions for the current conversation.
Meeting notesStart recording.
ModesSwitch to Work or Code.
ContextOpen My connectors or Instructions.
ExtensionsGo to Extensions.
SettingsChange theme, Log out, adjust or reset font size, and Open settings.
ViewToggle sidebar, Go back, and Toggle Panels.
WindowClose window, Reload, and Force reload.
ActionsOpen 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.

Start your next coding task, follow its progress, or review a completed change. Use parallel tasks when work needs separate checkouts or delegated conversations.