Complete Keyboard Shortcuts Reference
Maestro is designed for keyboard-first navigation. This page documents every keyboard shortcut in the application. For a beginner-friendly guide, see Keyboard Shortcuts.
Shortcuts use macOS notation by default. Replace Cmd with Ctrl and Opt with Alt on Windows/Linux.
Global Shortcuts
These shortcuts work anywhere in the app:
| Action | macOS | Windows/Linux | Description |
|---|
| Quick Actions | Cmd+K | Ctrl+K | Open command palette |
| Show Shortcuts | Cmd+/ | Ctrl+/ | Display keyboard shortcuts help |
| Open Settings | Cmd+, | Ctrl+, | Open application settings |
| Agent Settings | Opt+Cmd+, | Alt+Ctrl+, | Open current agent settings |
| Usage Dashboard | Opt+Cmd+U | Alt+Ctrl+U | View usage analytics |
| System Logs | Opt+Cmd+L | Alt+Ctrl+L | Open system log viewer |
| Process Monitor | Opt+Cmd+P | Alt+Ctrl+P | View system process monitor |
Agent Management
| Action | macOS | Windows/Linux | Description |
|---|
| New Agent | Cmd+N | Ctrl+N | Create new agent |
| New Agent Wizard | Cmd+Shift+N | Ctrl+Shift+N | Launch agent creation wizard |
| New Group Chat | Opt+Cmd+C | Alt+Ctrl+C | Create new group chat |
| Remove Agent | Cmd+Shift+Backspace | Ctrl+Shift+Backspace | Delete current agent |
| Move to Group | Cmd+Shift+M | Ctrl+Shift+M | Move agent to different group |
| Next Agent | Cmd+] | Ctrl+] | Switch to next agent |
| Previous Agent | Cmd+[ | Ctrl+[ | Switch to previous agent |
| Jump to Agent 1-9 | Opt+Cmd+1-9 | Alt+Ctrl+1-9 | Jump to specific agent by number |
| Jump to Agent 10 | Opt+Cmd+0 | Alt+Ctrl+0 | Jump to 10th agent |
Navigation
| Action | macOS | Windows/Linux | Description |
|---|
| Navigate Back | Cmd+Shift+, | Ctrl+Shift+, | Go back in navigation history |
| Navigate Forward | Cmd+Shift+. | Ctrl+Shift+. | Go forward in navigation history |
| Toggle Left Panel | Opt+Cmd+ArrowLeft | Alt+Ctrl+ArrowLeft | Show/hide left sidebar |
| Toggle Right Panel | Opt+Cmd+ArrowRight | Alt+Ctrl+ArrowRight | Show/hide right panel |
| Focus Left Panel | Cmd+Shift+A | Ctrl+Shift+A | Focus agent list in left panel |
| Toggle Input/Output | Cmd+. | Ctrl+. | Switch focus between input and output |
| Jump to Bottom | Cmd+Shift+J | Ctrl+Shift+J | Scroll to bottom of output |
Mode Switching
| Action | macOS | Windows/Linux | Description |
|---|
| Switch AI/Terminal | Cmd+J | Ctrl+J | Toggle between AI and terminal mode |
| Go to Files Tab | Cmd+Shift+F | Ctrl+Shift+F | Switch to Files tab in right panel |
| Go to History Tab | Cmd+Shift+H | Ctrl+Shift+H | Switch to History tab in right panel |
| Go to Auto Run Tab | Cmd+Shift+1 | Ctrl+Shift+1 | Switch to Auto Run tab in right panel |
AI Tab Management
| Action | macOS | Windows/Linux | Description |
|---|
| New Tab | Cmd+T | Ctrl+T | Create new AI tab |
| Close Tab | Cmd+W | Ctrl+W | Close current tab |
| Close All Tabs | Cmd+Shift+W | Ctrl+Shift+W | Close all tabs in current agent |
| Close Other Tabs | Opt+Cmd+W | Alt+Ctrl+W | Close all tabs except current |
| Close Tabs to Left | Cmd+Shift+Opt+[ | Ctrl+Shift+Alt+[ | Close all tabs to the left |
| Close Tabs to Right | Cmd+Shift+Opt+] | Ctrl+Shift+Alt+] | Close all tabs to the right |
| Reopen Closed Tab | Cmd+Shift+T | Ctrl+Shift+T | Restore last closed tab |
| Next Tab | Cmd+Shift+] | Ctrl+Shift+] | Switch to next tab |
| Previous Tab | Cmd+Shift+[ | Ctrl+Shift+[ | Switch to previous tab |
| Tab Switcher | Opt+Cmd+T | Alt+Ctrl+T | Open tab switcher modal |
| Go to Tab 1-9 | Cmd+1-9 | Ctrl+1-9 | Jump to specific tab by number |
| Go to Last Tab | Cmd+0 | Ctrl+0 | Jump to last tab |
| Rename Tab | Cmd+Shift+R | Ctrl+Shift+R | Rename current tab |
| Toggle Tab Star | Cmd+Shift+S | Ctrl+Shift+S | Star/unstar current tab |
| Filter Unread Tabs | Cmd+U | Ctrl+U | Show only unread tabs |
| Toggle Tab Unread | Cmd+Shift+U | Ctrl+Shift+U | Mark current tab as unread |
| Toggle Bookmark | Cmd+Shift+B | Ctrl+Shift+B | Bookmark current message |
Tab Settings
| Action | macOS | Windows/Linux | Description |
|---|
| Toggle Read-Only | Cmd+R | Ctrl+R | Toggle read-only mode for tab |
| Toggle Save to History | Cmd+S | Ctrl+S | Toggle automatic history saving |
| Toggle Show Thinking | Cmd+Shift+K | Ctrl+Shift+K | Cycle thinking display mode |
Git Integration
| Action | macOS | Windows/Linux | Description |
|---|
| View Git Diff | Cmd+Shift+D | Ctrl+Shift+D | Open git diff viewer |
| View Git Log | Cmd+Shift+G | Ctrl+Shift+G | Open git commit log |
| Agent Sessions | Cmd+Shift+L | Ctrl+Shift+L | Browse provider sessions |
Auto Run
| Action | macOS | Windows/Linux | Description |
|---|
| Toggle Edit/Preview | Cmd+E | Ctrl+E | Switch between edit and preview mode |
| Toggle Auto Run Expanded | Cmd+Shift+E | Ctrl+Shift+E | Expand/collapse Auto Run panel |
File Operations
| Action | macOS | Windows/Linux | Description |
|---|
| Fuzzy File Search | Cmd+G | Ctrl+G | Quick file navigation |
| Copy File Path | Cmd+P | Ctrl+P | Copy file path (in preview) |
| Open Image Carousel | Cmd+Y | Ctrl+Y | Open image lightbox carousel |
Modals & Special Views
| Action | macOS | Windows/Linux | Description |
|---|
| Open Prompt Composer | Cmd+Shift+P | Ctrl+Shift+P | Open prompt composer modal |
| Maestro Symphony | Cmd+Shift+Y | Ctrl+Shift+Y | Open Symphony contribution view |
| Director’s Notes | Cmd+Shift+O | Ctrl+Shift+O | View Director’s Notes (Encore) |
| Toggle Auto-Scroll | Opt+Cmd+S | Alt+Ctrl+S | Toggle auto-scroll in AI output |
Context-Specific Shortcuts
These shortcuts work within specific contexts:
File Explorer (Right Panel - Files Tab)
| Action | Key | Description |
|---|
| Filter Files | Cmd+F / Ctrl+F | Filter file list |
History Panel (Right Panel - History Tab)
| Action | Key | Description |
|---|
| Filter History | Cmd+F / Ctrl+F | Filter history entries |
System Log Viewer
| Action | Key | Description |
|---|
| Search Logs | Cmd+F / Ctrl+F | Search log entries |
Main Output Window
| Action | Key | Description |
|---|
| Search Output | Cmd+F / Ctrl+F | Search AI/terminal output |
File Preview
| Action | Key | Description |
|---|
| Go Back | Cmd+ArrowLeft / Ctrl+ArrowLeft | Previous file in history |
| Go Forward | Cmd+ArrowRight / Ctrl+ArrowRight | Next file in history |
Left Panel (Agent List)
| Action | Key | Description |
|---|
| Filter Sessions | Cmd+F / Ctrl+F | Filter agent list |
Director’s Notes
| Action | Key | Description |
|---|
| Search Notes | Cmd+F / Ctrl+F | Search Director’s Notes |
Universal Shortcuts
| Action | Key | Description |
|---|
| Close Modal/Overlay | Esc | Close top-most modal or overlay |
| Confirm Dialog | Enter | Confirm action in dialog |
| Cancel Dialog | Esc | Cancel action in dialog |
Customization
You can customize most shortcuts in Settings → Keyboard Shortcuts. Non-editable shortcuts (like context-specific Cmd+F for filtering) are displayed in the help modal but cannot be changed.
Hold Opt+Cmd (macOS) or Alt+Ctrl (Windows/Linux) to display numbered badges on agents for quick jumping.