Reference and troubleshooting
Keyboard and menu reference
These shortcuts describe the macOS app. Menu actions follow the active window and terminal; an open dialog can temporarily own or suppress a shortcut.
Navigation
| Shortcut | Action |
|---|---|
| Cmd+P | Jump to terminal by name or tag. |
| Ctrl+Tab / Ctrl+Shift+Tab | Hold Ctrl to cycle recent terminals forward/backward; release to select. |
| Ctrl+Option+Tab, with optional Shift | Cycle recent groups; release Ctrl to select. |
Ctrl+ / Ctrl+Shift+ | Next/previous tab within an open tag page. |
| Cmd+Shift+] / Cmd+Shift+[ | Next/previous terminal within the current group, including from standalone view. |
| Cmd+S | View → Toggle Sidebar. |
| Cmd+1 / Cmd+2 / Cmd+3 outside the command selector | Select All, Failed, or Running terminal filters. |
Numbered shortcuts no longer switch tag groups; Cmd+4 through Cmd+9 are unassigned. Inside the saved-command selector, Cmd+1 through Cmd+3 keep their command-selection meaning.
Arrow keys move through a quick-search result list; Enter selects and Escape dismisses. Escape cancels the held recent switchers. The terminal and group switchers need at least two choices.
Commands
| Shortcut or menu | Action |
|---|---|
| Cmd+I; Action → Generate command… | Open Command Assistant for the active terminal. Requires an idle shell prompt to generate. |
| Enter in Command Assistant | Submit a description or clarification answer; the resulting command is inserted for review. |
| Escape in Command Assistant | Cancel generation and close the assistant. |
| Cmd+R; Action → Run saved command | Open the selector for the active terminal. |
| Up / Down in selector | Choose a command row; selection wraps. |
| Enter in selector | Run the highlighted saved command. |
| Cmd+1 / Cmd+2 / Cmd+3 in selector | Run the first, second, or third selectable match. |
| Escape in selector | Clear a nonempty filter, then close when empty. |
| Cmd+.; Action → Stop command | Stop active managed or visible manual work. |
| Action → Stop all | Stop work across terminals. |
| Tag menu → Start all / Stop all | Start eligible members or stop that group's work. |
Run choices are disabled during managed or visible manual work and during a start/stop operation. Section labels do not count as numbered command choices. See Running and stopping for foreground replacement and bulk-start rules.
Command Assistant inserts editable text without executing it. Press Enter separately at the terminal prompt when ready to run it. Plain Ctrl+I remains available to the shell.
Editors
| Shortcut or menu | Action |
|---|---|
| Cmd+T; File → New Terminal | Quick-create an automatically named terminal. |
| Cmd+=; main sidebar + | Open the full New terminal editor. |
| Cmd+E; File → Edit Terminal | Edit the selected profile. |
| Cmd+Option+D; File → Duplicate Terminal | Duplicate the selected profile. |
| Cmd+Enter in profile editor | Save the profile draft. |
| Cmd+Enter in Advanced command editor | Apply only that command draft; save the profile afterward. |
| Escape in Advanced | Cancel only the command draft. |
| Cmd+,; Preferences or sidebar gear | Open or focus Settings. |
| Cmd+W in Settings | Validate/flush Settings and close it; invalid command drafts can keep it open. |
Plain Enter inside a multiline command adds a line. Settings autosaves valid edits, while the profile editor has an explicit Save step. A nested Advanced dialog owns Apply/Escape so those keys do not accidentally save or close its parent.
Terminal actions
| Shortcut or menu | Action |
|---|---|
| Cmd+/; Action → Go to working dir | Return a fully idle shell to its explicit configured directory. |
| Cmd+F with terminal focused | Find text in that terminal's buffer. |
| Enter / Shift+Enter in Find | Next/previous match. |
| Cmd+Down Arrow with terminal focused | Return to live output. |
| Cmd+K with terminal focused | Clear output and the persisted scrollback snapshot. |
| Cmd+C / Cmd+V | Copy selected text / paste. |
| Cmd+click a web URL | Open the URL in your browser. |
| Cmd+O; File → Import .terminalis File… | Review a portable file for import. |
| File → Export Current Terminal… | Export the selected terminal. |
| Cmd+W in the main window; File → Delete Terminal | Delete the selected profile; configured profiles require confirmation. |
| Terminal menu → Re-Initialize | Replace the shell and clear output. |
| Cmd+Q | Quit, with confirmation when tracked work is active. |
| Help → Open Diagnostics Folder… | Open this app instance’s local diagnostic records. |
Ctrl+C belongs to the shell and interrupts work. Cmd+W in the main window is a deletion action, not a way to hide a terminal tab. Active-terminal menu actions are disabled when no terminal is selected or when the Settings window owns the menu context.