Keyboard shortcuts
mocante takes its shortcuts before the terminal does, so they work while a full-screen program such as an agent’s TUI has the keyboard. They also work while a page in the built-in browser has the keyboard.
Press ⌘? (Ctrl+? on Linux) to see this list in the app. Context menus and the command palette show the shortcut beside each action that has one.
macOS and Linux
Section titled “macOS and Linux”On Linux, Ctrl takes the place of ⌘ in every shortcut, with these exceptions:
- Jump to a session by position is
Alt+1toAlt+9, becauseCtrl+1toCtrl+9jump to tabs. - Back and forward are
Alt+←andAlt+→, becauseCtrl+[is Escape in a terminal. - Replace in file is
Ctrl+H, and replace across the worktree isCtrl+Shift+H, becauseAlttypes characters on some layouts.
On macOS the ⌘ shortcuts do not also accept Ctrl. Ctrl+W, Ctrl+K and Ctrl+B reach the shell and tmux as usual.
Global
Section titled “Global”| Action | macOS | Linux |
|---|---|---|
| Command palette, waiting agents first | ⌘K |
Ctrl+K |
| Command palette, commands mode | ⌘⇧P |
Ctrl+Shift+P |
| Show or hide the sidebar | ⌘B |
Ctrl+B |
| Settings | ⌘, |
Ctrl+, |
| Keyboard shortcuts | ⌘? |
Ctrl+? |
| Close a dialog or the palette | esc or ⌘. |
Esc |
| Submit a dialog | ↩ |
Enter |
| Submit a dialog from a text area | ⌘↩ |
Ctrl+Enter |
| Developer tools (View › Developer) | ⌥⌘I |
Ctrl+Shift+I |
In a dialog, an open suggestion list takes ↩ first. The buttons of a dialog show the key that presses them, as your platform labels it.
Confirmation dialogs
Section titled “Confirmation dialogs”Closing a session, deleting a worktree or branch, and removing a workspace ask you to confirm. The confirm button has the keyboard, so ↩ confirms and esc cancels. Each option in the dialog shows the key that turns it on or off:
| Option | macOS | Linux and Windows |
|---|---|---|
| Also remove the worktree and delete the branch | B |
Alt+B or B |
| Also delete the files on disk | F |
Alt+F or F |
On Linux and Windows, Alt and the letter is the access key, as in other apps there. macOS has no access keys, so the letter alone does it. To close a session and remove its worktree, press B and then ↩.
On macOS, the menu bar shows most of these shortcuts beside the items that do the same thing.
Permission requests
Section titled “Permission requests”When an agent tool or a 1Password secret waits for your approval, these keys answer the first request in the bar at the top of the session. Its buttons show them.
| Action | macOS | Linux |
|---|---|---|
| Allow, or allow once | ⌘⇧A |
Ctrl+Shift+A |
| Allow for this session | ⌘⇧S |
Ctrl+Shift+S |
| Deny | ⌘⇧D |
Ctrl+Shift+D |
⌘⇧A and ⌘⇧S do not approve a secret while the palette, a dialog, the share viewer or a peek pane is open, or in a pop-out window, because then you cannot read the secrets it grants. Holding a key down answers only one request.
The keys never reach the terminal, even while no request waits, so a late Ctrl+Shift+D is not sent to the shell as Ctrl+D. While a page in the built-in browser has the keyboard, the page gets them.
Tabs and sessions
Section titled “Tabs and sessions”| Action | macOS | Linux |
|---|---|---|
| New shell tab in this session | ⌘T or ⌥⇧T |
Ctrl+T or Alt+Shift+T |
| Close the current tab | ⌘W or ⌥⇧W |
Ctrl+W or Alt+Shift+W |
| Reopen the tab or session you just closed | ⌘⇧T |
Ctrl+Shift+T |
| Previous or next tab | ⌘⇧[ / ⌘⇧], or ⌥⇧[ / ⌥⇧] |
Ctrl+Shift+[ / Ctrl+Shift+], or Alt+Shift+[ / Alt+Shift+] |
| Previous or next tab | Ctrl+PageUp / Ctrl+PageDown |
Ctrl+PageUp / Ctrl+PageDown |
| Jump to tab 1 to 8 | ⌘1 to ⌘8 |
Ctrl+1 to Ctrl+8 |
| Jump to the last tab | ⌘9 |
Ctrl+9 |
| Jump to session 1 to 9, by its place in the sidebar | ⌃1 to ⌃9 |
Alt+1 to Alt+9 |
| Previous or next session | ⌘⌥↑ / ⌘⌥↓ |
Ctrl+Alt+↑ / Ctrl+Alt+↓ |
| Previous or next session that needs you | ⌘⌥⇧↑ / ⌘⌥⇧↓ |
Ctrl+Alt+Shift+↑ / Ctrl+Alt+Shift+↓ |
| In the palette: new session in the highlighted row’s workspace | ⌘↩ |
Ctrl+Enter |
| In New session: start in the background, keep the dialog for the next | ⌘↩ |
Ctrl+Enter |
| In New session: start in the background and close the dialog | ⌘⇧↩ |
Ctrl+Shift+Enter |
“Needs you” means an agent that waits for input or has failed.
Switching tabs moves the keyboard into that tab’s terminal, so you can type at once. ⌘W does nothing on the last tab of a session. Close the session instead.
⌘⇧T works for five seconds after a close of a terminal tab or a session, and each press undoes the next most recent close. In the web UI in a browser, the browser keeps ⌘⇧T, so use Undo in the notice, or Reopen closed tab (Undo closing session after a session close) in the palette.
In the scratchpad, the same keys open, close and switch the note tabs. ⌘W on the last note tab hides the scratchpad.
In agent docs, they switch and close the document tabs, and ⌘T opens Open a Claude document…. ⌘W on the last document tab hides the pane.
Navigation and panes
Section titled “Navigation and panes”Press F6 to move the keyboard between the sidebar and the view, and Shift+F6 to go
back. It opens the sidebar if it is shut.
In the sidebar:
| Key | Action |
|---|---|
↑ / ↓ |
Previous or next row |
Home / End |
First or last row |
→ |
Open a closed row, or go into an open one |
← |
Close an open row, or go to its parent |
Enter or Space |
Open the row |
Tab |
The star and close buttons of the row, then out of the list |
| Menu key | The right-click menu of the row |
| Action | macOS | Linux |
|---|---|---|
| Go back or forward through the places you visited | ⌘[ / ⌘] |
Alt+← / Alt+→ |
| Move the keyboard to the previous or next pane | ⌘⌥← / ⌘⌥→ |
Ctrl+Alt+← / Ctrl+Alt+→ |
| Float the focused pane, or put it back | ⌘⌥↩ |
Ctrl+Alt+Enter |
| Maximize the focused pane, or restore the panes | ⌘⇧↩ |
Ctrl+Shift+Enter |
| Show or hide the code pane | ⌘⇧E |
Ctrl+Shift+E |
| Show or hide the scratchpad | ⌘⇧; |
Ctrl+Shift+; |
See panes for how panes sit side by side.
Terminal
Section titled “Terminal”| Action | macOS | Linux |
|---|---|---|
| Copy the selection | ⌘C |
— |
| Paste | ⌘V |
— |
On Linux, Ctrl+C is the terminal’s interrupt, so use the terminal’s context menu to copy and paste.
Code view
Section titled “Code view”While the code view has the keyboard, the tab shortcuts act on code tabs: ⌘T opens a worktree browser, ⌘W closes the code tab, and the next, previous and number shortcuts move between code tabs.
| Action | macOS | Linux |
|---|---|---|
| Go to file | ⌘P |
Ctrl+P |
| Find in file | ⌘F |
Ctrl+F |
| Replace in file | ⌘⌥F |
Ctrl+H |
| Next change | ⌥F5 |
Alt+F5 |
| Previous change | ⌥⇧F5 |
Alt+Shift+F5 |
| Search the worktree | ⌘⇧F |
Ctrl+Shift+F |
| Search and replace across the worktree | ⌘⌥⇧F |
Ctrl+Shift+H |
| Save the file | ⌘S |
Ctrl+S |
| Comment on the selected lines | ⌘⇧M |
Ctrl+Shift+M |
| Add a review comment to the review | ⌘↩ |
Ctrl+Enter |
| Send a review comment now | ⌘⇧↩ |
Ctrl+Shift+Enter |
Go to file, find in file and the change shortcuts work only in the code view, because a shell uses Ctrl+P, Ctrl+F and Ctrl+H itself. The two worktree searches work from anywhere and open the code pane. See code view.
Browser
Section titled “Browser”| Action | macOS | Linux |
|---|---|---|
| Select the address bar | ⌘L |
Ctrl+L |
| Reload the page | ⌘R |
Ctrl+R |
These work only while the browser pane has the keyboard, because Ctrl+L clears a terminal and Ctrl+R searches its history. See browser.
| Action | macOS | Linux |
|---|---|---|
| Collapse the other projects, or expand all again | ⌥-click a project’s caret |
Alt-click a project’s caret |
| Show a pane on its own | ⌥-click its button in the session header |
Alt-click its button |
| Make a pane follow the session in view | ⇧-click its button in the session header |
Shift-click its button |
| Open a pop-out window that follows the session in view | ⇧-click the pop-out button |
Shift-click the pop-out button |
In a browser tab
Section titled “In a browser tab”When you use the web UI in a browser, the browser keeps some shortcuts for its own tab strip and never passes them to the page. Nothing mocante does can get them back:
- Chrome on macOS keeps
⌘T,⌘W,⌘⇧[/⌘⇧], and⌘1to⌘9. - Chrome on Linux and Windows keeps
Ctrl+T,Ctrl+W,Ctrl+1toCtrl+9,Ctrl+PageUpandCtrl+PageDown.
Use these instead:
| Action | macOS | Linux |
|---|---|---|
| New tab | ⌥⇧T |
Alt+Shift+T |
| Close tab | ⌥⇧W |
Alt+Shift+W |
| Previous or next tab | ⌥⇧[ / ⌥⇧] |
Alt+Shift+[ / Alt+Shift+] |
| Jump to a session | ⌃1 to ⌃9 |
Alt+1 to Alt+9 |
In the web UI, menus and the palette show these forms.