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

​

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

​

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

​

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.

​

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.