Keyboard shortcuts

On a Mac, press ⌘K for the command palette, ⌘N for a new workspace, ⌘T for a new chat tab and ⌘1 to ⌘9 to jump between workspaces. On Windows and Linux the same shortcuts use Ctrl instead of ⌘, as the full list below shows.

Updated

The command palette over a workspace: a search box reading Jump to a workspace or run an action, the four workspaces with their repository and branch, then actions for the workspace on screen such as Open in Finder, Open in VS Code and Run server.
⌘K (Ctrl+K on Windows and Linux) jumps to any workspace or runs an action on the one you are in.

What are all the shortcuts?

macOSWindows and LinuxAction
⌘N Ctrl+N New workspace
⌘⇧N Ctrl+Shift+N New workspace on a branch that already exists or on a pull request
⌘O Ctrl+O Add a repository
⌘T Ctrl+T New chat tab in the current workspace
⌘W Ctrl+W Close the current chat tab
⌘⇧T Ctrl+Shift+T Reopen the chat tab you closed last
⌘1 … ⌘9 Ctrl+1 … Ctrl+9 Jump to a workspace by its position in the sidebar
⌃Tab / ⌃⇧Tab Ctrl+Tab / Ctrl+Shift+Tab Next or previous chat tab
⌘K Ctrl+K Command palette: jump to a workspace or run an action
⌘B Ctrl+B Show or hide the sidebar
⌘J Ctrl+J Show or hide the terminal drawer
⌘⇧E Ctrl+Shift+E Show or hide the Changes panel
⌘⇧D Ctrl+Shift+D Open the diff viewer on the first changed file, or close it
⌘⇧P Ctrl+Shift+P Create a pull request
⌘⌥R Ctrl+Alt+R Ask an agent to review the workspace’s changes
⌘⇧A Ctrl+Shift+A Go to the next workspace that needs you
⌘⇧O Ctrl+Shift+O Open the workspace in your default app: the one you chose, else the first editor installed
⌘, Ctrl+, Settings
⌘/ Ctrl+/ List every shortcut
Esc Esc Stop the running turn (when the message box is focused and empty)
Enter or ⌘Enter Enter or Ctrl+Enter Send the message (Settings → General → Send messages with chooses which)

On a Mac, ⌘ is Command, ⌃ is Control and ⇧ is Shift. Menus show the keys for the system you are on.

What can the command palette do?

⌘K (Ctrl+K on Windows and Linux) opens a search box that jumps to any workspace by name and runs actions: new workspace, new tab, start or stop a run script, run the setup script again, create a pull request or open its checks, open the workspace in another app, pin it, set its status, copy its branch name, archive it, open a Settings section, switch the theme and show or hide the panels.

How do I choose whether Enter sends a message?

In Settings → General → Send messages with, choose Enter sends (Shift+Enter starts a new line) or ⌘Enter sends (Ctrl+Enter on Windows and Linux; Enter starts a new line).

How do I stop an agent quickly?

Press Esc while the message box is focused and empty. A message you send while the agent is working waits in a queue above the message box; choose Send now on it to interrupt the turn and send it straight away.

Where to go next

Get microManager

Free, no account, for macOS, Windows and Linux. It runs the agent CLIs you already have installed and signed in.

curl -fsSL https://micromanager.win/install.sh | sh

That installs it on macOS and Linux. On Windows, paste this into PowerShell:

irm https://micromanager.win/install.ps1 | iex