Keyboard Shortcuts

​

Quick Actions (Cmd+K)

The command palette is your gateway to nearly every action in Maestro. Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) to open it.

​

System-Wide Hotkey (Summon Maestro)

Configure a single OS-level hotkey that summons Maestro - bringing the window to the foreground and focusing it - from any application on macOS, Windows, or Linux. This is the only shortcut in Maestro that fires while the app is in the background; every other shortcut on this page is in-app. To configure:

1. Open Settings (Cmd+, / Ctrl+,) → General tab
2. Find Global Hotkey to Show Maestro
3. Click the key capture button and press your desired combo
4. Leave it blank to disable the binding

Tips and gotchas:

• Pick a combo with two modifiers (e.g. Cmd+Shift+M / Win+Shift+M) to avoid clashing with app shortcuts.
• If the OS or another app already owns the combo, Maestro will surface a registration failure - pick a different binding.
• Meta maps to Cmd on macOS and Win (Super) on Windows/Linux automatically.
• The hotkey works even when Maestro is hidden, minimized, or behind other windows.

​

Global Shortcuts

​

Panel Shortcuts

​

AI Tab Shortcuts

These shortcuts work in AI Terminal mode and affect the current tab: Toggle states are saved per-tab. See Input Toggles for details on configuring defaults.

​

Tab Management Shortcuts

​

Tab Switcher

The Tab Switcher provides fuzzy search across all open tabs with quick navigation:

• Search - Type to filter tabs by name or session ID
• Quick select - Press 1-9 to jump directly to a numbered tab
• Navigate - Use Up/Down Arrow to move through results
• Select - Press Enter to switch to the highlighted tab
• Context info - Each tab shows token count, cost, and context usage

The bulk close operations (Close All, Close Others, Close Left, Close Right) are also available via the Tab Menu hover overlay and Quick Actions (Cmd+K).

​

Input & Output

​

Font Size

​

Command Terminal

​

Tab Completion

The Command Terminal - and the AI chat while in command mode - provides intelligent tab completion for faster command entry: Completion Sources:

• History - Previous shell commands from your session. In command mode this is your prior command-mode commands, so Tab on an empty line lists what you have run before
• Files/Folders - Files and directories in your current working directory. In command mode this is the agent’s working directory, which is where the command actually runs
• Git Branches - Local and remote branches (git repos only)
• Git Tags - Available tags (git repos only)

In git repositories, filter buttons appear in the dropdown header allowing you to filter by type (All, History, Branches, Tags, Files). Use Tab/Shift+Tab to cycle through filters or click directly.

​

@ File Mentions (AI Terminal)

In AI mode, use @ to reference files in your prompts: Example: Type @readme to see matching files, then select to insert the file reference into your prompt. The AI will have context about the referenced file.

​

Navigation & Search

​

Searching Message History

Two searches cover your conversations, both reachable from the magnifying-glass menu in the tab bar and both supporting plain text or regex: The Find bar highlights matches inline; Enter and Shift+Enter step through them. Cross-tab search opens a modal listing hits grouped by tab. Choosing one switches to that tab, scrolls to the message, flashes it, and seeds that tab’s Find bar with the same query positioned on the match you picked. It is also in the command palette as “Search: Messages (All Agent Tabs)”. See Searching Message History for the full walkthrough.

​

File Preview

​

CSV Row Detail

Available while previewing a .csv or .tsv file. See CSV and TSV Tables for the full walkthrough. The field list is focused on open, so these work without clicking first.

​

Document Graph

​

Customizing Shortcuts

Most shortcuts can be remapped to fit your workflow:

1. Open Settings (Cmd+, / Ctrl+,) → Shortcuts tab
2. Find the action you want to remap
3. Click the current key binding (shows the shortcut like ⌘ K or Ctrl+K)
4. Press your desired key combination
5. The new binding is saved immediately

Tips:

• Press Esc while recording to cancel without changing the shortcut
• Modifier keys alone (Cmd, Ctrl, Alt, Shift) won’t register - you need a final key
• Some shortcuts are fixed and cannot be remapped (like Esc to close modals)
• Conflicting shortcuts will override the previous binding

Resetting shortcuts: There’s currently no “reset to default” button - if you need to restore defaults, you can find the original bindings in this documentation or delete the shortcuts from your settings file.

​

Changed Default Bindings

When a default binding has to move to free a combo for a new action, Maestro migrates it for you on the next launch - but only if you were still on the old default. If you had personally rebound that action, your binding is left untouched and you may need to move it yourself. If Opt+Cmd+F still focuses the active tab instead of opening cross-tab search, you had a custom binding on it: open Settings → Shortcuts, clear it from Focus Active Tab, and the new default takes over.

​

Keyboard Mastery

Maestro tracks your keyboard shortcut usage and rewards you for becoming a power user. As you discover and use more shortcuts, you’ll level up through 5 mastery levels: Tracking your progress:

• Open the Shortcuts Help panel (Cmd+/ / Ctrl+/) to see your mastery percentage and current level
• Each shortcut displays a checkmark once you’ve used it
• A progress bar shows how many shortcuts you’ve mastered out of the total
• When you reach a new level, you’ll see a celebration with confetti

The modal shows all available shortcuts with checkmarks indicating which you’ve mastered. Use the search bar to find specific shortcuts quickly. Why keyboard shortcuts matter: Using shortcuts keeps you in flow state, reduces context switching, and dramatically speeds up your workflow. Maestro is designed for keyboard-first operation - the less you reach for the mouse, the faster you’ll work. Keyboard Mastery is separate from Conductor Ranks, which track cumulative Auto Run time. Both systems reward you for mastering different aspects of Maestro.