Keyboard Shortcuts

Complete guide to all keyboard shortcuts in Agentastic. Shortcuts are customizable - this reference shows the defaults.

Essential Shortcuts

Global Shortcuts

These work from any application when Agentastic is running:

Launcher Shortcuts

Available when the launcher is open:

Navigation Shortcuts

Within Launcher

Text Navigation

Expansion Shortcuts

Trigger Controls

Quick Expansions

AI Feature Shortcuts

AI Mode Controls

AI Tools

Editing Shortcuts

Standard Editing

Advanced Editing

Settings Shortcuts

In Settings Window

Quick Settings

Application-Specific

Email Clients (Mail, Outlook)

Code Editors (VS Code, Xcode)

Web Browsers

Custom Shortcuts

Creating Custom Shortcuts

1. Open Settings (⌘+,)
2. Navigate to Shortcuts
3. Click "Add Shortcut"
4. Press key combination
5. Assign action

Action Types

• Expansion - Trigger specific expansion
• Command - Run AI command
• Tool - Activate tool
• Workflow - Execute workflow
• Script - Run custom script

Examples

custom_shortcuts:
  - keys: "cmd+shift+t"
    action: "insert_timestamp"
    
  - keys: "cmd+shift+e" 
    action: "/email compose"
    
  - keys: "ctrl+opt+d"
    action: "duplicate_and_increment"

Modifier Keys

Key Symbols

Modifier Combinations

• ⌘ + letter = Primary action
• ⌘+⇧ + letter = Secondary action
• ⌘+⌥ + letter = Alternative action
• ⌃+⌥ + letter = Advanced action

Accessibility Shortcuts

VoiceOver Support

Display

Troubleshooting Shortcuts

Shortcut Conflicts

Common conflicts and solutions:

1. Spotlight (⌘+Space)

   • Change Spotlight to ⌃+Space
   • Or change Agentastic launcher

2. Mission Control

   • Modify in System Settings
   • Use different modifier

3. App-specific

   • Check app preferences
   • Use alternative binding

Reset Shortcuts

To reset all shortcuts to defaults:

agentastic shortcuts reset

Or in UI:

1. Settings → Shortcuts
2. Click "Reset All"
3. Confirm

Platform Differences

macOS vs Windows (Future)

Tips for Learning Shortcuts

Start With These

1. ⌘+Space - Open launcher
2. ⌘+1 - Toggle Agent Mode
3. ⌘+2 - Toggle Bundle Mode
4. ⌘+3 - Toggle Vision Mode
5. ⌘+S - Bookmark conversation
6. ⌘+N - New conversation
7. Hold Space - Voice input
8. ⌘+Q - Close launcher
9. ⎋ - Cancel API request
10. ⌘+, - Settings

Practice Routine

1. Week 1: Master essential shortcuts
2. Week 2: Add navigation shortcuts
3. Week 3: Learn AI shortcuts
4. Week 4: Customize your own

Memory Aids

• Navigation: Arrow keys for movement
• Actions: Return for accept, Escape for cancel
• Modifiers: Cmd for primary, Shift for variants

Quick Reference Card

Print this for your desk:

ESSENTIAL
---------
⌘+Space    = Launcher
⌘+T        = New tab
⌘+W        = Close tab
⌥+⌘+W      = Close all
⌘+N        = New conversation
⌘+S        = Bookmark conversation
⌘+Q        = Close overlay
⎋          = Cancel request
⌘+,        = Settings

WINDOW MODES
------------
⌘+F        = Toggle size (minimize ↔ expand)
⌥+⌘+O      = Toggle mode (overlay ↔ window)

AI MODES
--------
⌘+1        = Agent Mode
⌘+2        = Bundle Mode
⌘+3        = Vision Mode
⌘+4        = Thinking Mode
⌘+5        = Search Mode
⌘+6        = Imagine Mode
Hold Space = Voice input
⌘+E        = Email
⌘+K        = Quick search

EDITING
-------
⌘+A        = Select all
⌘+Z        = Undo
⌘+C/X/V    = Copy/Cut/Paste

NAVIGATION
----------
↑/↓        = Move selection
⏎          = Send/Accept
⇥          = Next field

Next Steps

• Customize shortcuts
• Create workflows
• Troubleshoot issues

Master these shortcuts to transform your productivity with Agentastic!