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.

​

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

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

​

Tab Completion (Command Terminal)

The Command Terminal provides intelligent tab completion for faster command entry: Completion Sources:

• History - Previous shell commands from your session
• Files/Folders - Files and directories in your current working directory
• 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

​

File Preview

​

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.

​

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:

• Your current mastery level is shown in the status bar at the bottom of the window
• Hover over the keyboard icon to see which shortcuts you’ve used and which remain to be discovered
• Open the Shortcuts Help modal (Cmd+/ / Ctrl+/) to see your mastery percentage and get hints
• When you reach a new level, you’ll see a celebration with confetti

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.