Skip to content

Context menus

Everything in mocante that has a name answers a right-click with the actions that apply to it. On a touch screen, touch and hold for a moment (about 0.8 seconds) to do the same. A swipe never opens the menu. The same actions are in the command palette, so a session offers the same items whether you right-click it in the sidebar, on a card or in the fleet list.

A menu shows the keyboard shortcut beside each item that has one, with the keys of your platform. In the web UI in a browser, it shows the ⌥⇧ forms, because the browser keeps ⌘T, ⌘W and ⌘⇧[ for itself.

A menu builds its items when it opens, so an item that is not available right now is greyed out. An item that only applies in some cases, such as Fork session… for a git session, is left out when it does not apply.

Right-click on Menu
Sidebar background New project…, Hosts, Settings… · Jump to agent…, Run a command…, Hide sidebar or Show sidebar, Keyboard shortcuts…
Project Open project, New workspace…, Edit project…, Collapse project in sidebar or Expand project in sidebar, Collapse other projects, Move up, Move down · Delete project…
Workspace Open workspace, New session…, Edit workspace…, Ask an agent for the setup command · Copy workspace path, Move up, Move down · Remove workspace…

Move up and Move down appear when there is something to move past. The order syncs to your other devices.

Right-click on Menu
Session, in the sidebar or on a card Open session · New tab, Fork session… (git sessions), Rename session…, Add to favorites or Remove from favorites, Settle session or Return to the list, Snooze session…, Move up, Move down · Send to agent…, Stop agent, Resume agent · Copy branch, Copy worktree path (or Copy path), Copy attach command, Copy link to session · Close session…
Tab, in the sidebar or the tab strip Open tab, Rename tab…, Move left, Move right, Move to session · Send to agent…, Stop agent, Resume agent · Close tab
Agent row in the fleet view The tab’s items, then the session’s items
Terminal Copy, Paste, Select all, Clear scrollback · the items of the tab on screen

Send to agent… appears when an agent runs in the tab, and Stop agent while it works. Resume agent appears when the tab ran an agent that mocante can resume. See agents.

Revoke agent approval… appears on the session on screen when you allowed some of its agents’ calls for the whole session. See agent tools.

Rename session… changes the name you see and keeps the session’s branch and worktree, and also its code tabs, browser pages, shared files and the requests that wait for your answer. A session you later start under a name that was in use gets none of these from the old session. Rename tab… sets the tmux window name, which then stays as you typed it instead of following the agent’s name.

Add to favorites moves the session to the Favorites section at the top of the sidebar. There, Move up and Move down reorder the favorites. See terminals.

Move to session lists the other sessions on the tab’s host and moves the tab to the one you pick. It is greyed out on the last tab of a session. See terminals.

Copy is available while the terminal has a selection. Paste needs clipboard access, which a browser only gives to a secure page such as localhost or https. Where the item is greyed out, ⌘V still pastes.

Right-click on Menu
Code tab Keep open, Show file, Unified diff, Side-by-side diff, Ignore whitespace (or Show whitespace changes), Show unchanged lines (or Fold unchanged lines) · Find in file, Replace in file · Next change, Previous change · Overwrite file on disk, Compare with disk (or Close compare), Reload from disk, while the file changed on disk under your edits · Comment on selection, Send review threads to agent, Discard review threads · Copy path, Open in your editor · Close code tab, Close other code tabs, Close all code tabs
Review thread in the code view Reply to review thread, Edit your last message in the thread · Send review thread now, Send review thread as a change request · Resolve review thread (or Reopen review thread) · Delete review thread…
File in the code view tree Open, Open in new tab · Download · Copy path
Changed file in the git panel Open diff, Open in new tab · Stage or Unstage · Copy path
Commit in the commit graph Open diff, Open in new tab · Copy commit hash, Copy subject

A code tab shows only the layouts it is not already in. Open in names the editor from settings, for example Open in VS Code, and appears only in the desktop app. See code view and git workflow.

Right-click on Menu
Worktree without a session Start session · Copy branch, Copy path · Delete worktree…
Branch without a worktree Start session · Copy branch · Delete branch…
Pull request Start session (or Open session), Open on GitHub · Copy branch, Copy link
Issue Start session… (or Open session), Open on GitHub · Copy link
Right-click on Menu
Dev server card or fleet row Start, Stop, Restart · Open in the browser pane, Open one of its ports, Show its terminal tab, Copy the address · Edit this server, Remove from the project…
Shared file Open in a new window, Copy the path on the host · Remove…
Host Edit host…, Trust new identity…, Log in over ssh…, Re-check connection, Update agent hooks and MCP · Copy address

A dev server shows Start while it is stopped and Stop while it runs. See dev servers and files.

On a host, Trust new identity… appears only when the machine answering at that address reports a different identity than before. Log in over ssh… appears for remote hosts. Update agent hooks and MCP appears for a connected host, and updates the hooks and MCP servers on it that are out of date. See remote hosts.

Items that delete, close or replace something, such as Delete project…, Close session…, Delete branch…, Delete review thread…, Remove from the project…, a shared file’s Remove… or Overwrite file on disk, open the same confirmation dialog as the matching button. Nothing is removed straight from a menu.

Three red items act at once, because nothing is lost: Deny permission answers the agent, Stop halts a dev server that Start runs again, and Discard review threads shows a notice with Undo.

A menu acts on what you right-clicked as it is when you pick the item. If that session ended in the meantime, or a new session started under the same name, the item does nothing and a notice says so.

In the desktop app, text fields have the usual Cut, Copy, Paste and Select All menu.

On macOS, the menu bar is laid out as in other Mac apps. An item acts on the window you are in, and does the same as its keyboard shortcut.

Menu Items
mocante About mocante, Check for Updates… · Settings… (⌘,) · Services · Hide mocante, Hide Others, Show All · Quit mocante
File New Tab (⌘T), New Project… · Close Tab (⌘W), Reopen Closed Tab or Session (⌘⇧T), Close Window (⌘⇧W)
Edit Undo, Redo · Cut, Copy, Paste, Paste and Match Style, Delete, Select All · Find (Find…, Find and Replace…, Find in Files…, Replace in Files…) · Speech
View Show Sidebar or Hide Sidebar (⌘B), Show Code Pane or Hide Code Pane (⌘⇧E) · Jump to Agent… (⌘K), Run a Command… (⌘⇧P) · Actual Size, Zoom In, Zoom Out · Toggle Full Screen
Go Back (⌘[), Forward (⌘]) · Previous Session, Next Session, Previous Session That Needs You, Next Session That Needs You · Previous Pane, Next Pane · Go to File… (⌘P) · Fleet Overview, Hosts
Window Minimize, Zoom · Show Previous Tab (⌘⇧[), Show Next Tab (⌘⇧]) · Bring All to Front, then the open windows
Help A search field, mocante Help (opens this guide), Keyboard Shortcuts (⌘?)

An item whose action does not apply to the window you are in, such as Find… outside the code pane, is greyed out. Check for Updates… shows only in a build that can update itself.

On Linux, the app keeps the default menu. Open settings with Ctrl+,, the command palette or the sidebar.