Context menus
Everything in mocante that has a name answers a right-click with the actions that apply to it. On a touch screen, a long press does the same. 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.
Sidebar and projects
Section titled “Sidebar and projects”| 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… · 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.
Sessions and tabs
Section titled “Sessions and tabs”| Right-click on | Menu |
|---|---|
| Session, in the sidebar or on a card | Open session · New tab, Fork session… (git sessions), Rename session…, Move up, Move down · Resume agent · Copy branch, Copy worktree path (or Copy path), Copy attach command · Close session… |
| Tab, in the sidebar or the tab strip | Open tab, Rename tab…, Move left, Move right · 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 |
Resume agent appears when the tab ran an agent that mocante can resume. See agents.
Rename session… changes the name you see and keeps the session’s branch and worktree. Rename tab… sets the tmux window name, which then stays as you typed it instead of following the agent’s name.
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.
Code view and git panel
Section titled “Code view and git panel”| Right-click on | Menu |
|---|---|
| Code tab | Keep open, Show file, Unified diff, Side-by-side diff, Ignore whitespace (or Show whitespace changes) · Find in file, Replace in file · Copy path, Open in your editor · Close code tab, Close other code tabs, Close all code tabs |
| File in the code view tree | Open, Open in new tab · 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.
Workspace view
Section titled “Workspace view”| 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 |
Dev servers, shared files and hosts
Section titled “Dev servers, shared files and hosts”| Right-click on | Menu |
|---|---|
| Dev server card or fleet row | Start, Stop, Restart · Open in the browser pane, 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 · 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 appears when an agent’s hooks on that host are out of date. See remote hosts.
Destructive items
Section titled “Destructive items”Items that delete or close something, such as Delete project…, Close session… or Delete branch…, open the same confirmation dialog as the matching button. Nothing is removed straight from a menu.
Text fields
Section titled “Text fields”In the desktop app, text fields have the usual Cut, Copy, Paste and Select All menu.