Essential Shortcuts

Master these keyboard shortcuts to use Agentastic efficiently. These commands will help you access features quickly without interrupting your workflow.

Primary Shortcuts

Launcher

⌘+\ - Open Agentastic Launcher (Global Hotkey)

• Your gateway to AI assistance and settings
• Customizable in preferences
• Works from any application

Select Text + Click Popup - Open Launcher with Context

• Select any text on your screen
• Click the small popup that appears
• Launcher opens with selected text as context
• Can be enabled/disabled in Settings → Text Selection Popup

Expansion Control

⌫ (Backspace) - Undo last expansion

• Press immediately after an expansion occurs
• Restores your original trigger text
• Works once per expansion

⌃+Space - Force expansion

• Use when automatic expansion doesn't trigger
• Helpful for inline expansions
• Works with selected text

Launcher Commands

Once the launcher is open:

Navigation

• ↑/↓ - Navigate through suggestions
• ⏎ (Return) - Select current item / Send message
• ⌘+Q - Close launcher overlay
• ⎋ (Escape) - Cancel current API request (if in progress)
• ⌘+, - Open settings

Quick Actions

• ⌘+T - Create new conversation tab
• ⌘+W - Close current conversation tab
• ⌘+N - Start new conversation
• ⌘+S - Save current conversation
• ⌘+1 - Toggle Agent Mode
• ⌘+2 - Toggle Bundle Mode (Super Intelligence)
• ⌘+3 - Toggle Vision Mode (screen capture)
• ⌘+4 - Toggle Thinking Mode (extended reasoning)
• ⌘+5 - Toggle Search Mode (live web search)
• ⌘+6 - Toggle Imagine Mode (image generation)
• ⌘+F - Toggle window size (minimize ↔ expand overlay)
• ⌥+⌘+O - Toggle window mode (overlay ↔ standard window)

AI Feature Shortcuts

During Text Input

• @ + keyword - Activate AI tools
  • @email - Email assistance
  • @calendar - Calendar integration
  • @search - Web search
  • @agent - AI agent mode

Model Selection

• @model:fast - Quick responses
• @model:smart - Balanced performance
• @model:genius - Most capable model

Text Expansion Shortcuts

Trigger Modifiers

• Space - Default trigger activation
• Tab - Alternative trigger (if configured)
• Enter - Trigger on new line (if enabled)

Special Expansions

• Double characters - Quick expansions
  • ;; - Previous clipboard
  • !! - Current date
  • @@ - Current time

System Integration

macOS Integration

• ⌘+C then trigger - Expand with clipboard content
• ⌘+A in launcher - Select all in current field
• ⌘+Z - Undo (works with expansions)

Application-Specific

Some shortcuts work differently in specific apps:

• Terminal: Tab completion respected
• Code editors: Smart indent preserved
• Email clients: Formatting maintained

Customizing Shortcuts

Change Launcher Shortcut

1. Open Agentastic Settings
2. Go to Shortcuts tab
3. Click on launcher shortcut
4. Press new key combination
5. Confirm change

Create Custom Shortcuts

You can assign shortcuts to:

• Specific expansions
• AI commands
• Memory channels
• Quick actions

Productivity Tips

Efficient Workflows

1. Quick Email Response

   ⌘+Space → Type message → @email → ⏎
   

2. Smart Calendar Entry

   ⌘+Space → "Meeting tomorrow 2pm" → @calendar → ⏎
   

3. Instant Search

   ⌘+Space → Query → @search → ⏎
   

Power User Combinations

• ⌘+Space, ⌘+V - Launcher with vision mode
• @screen:2 @model:fast - Specific screen with fast model
• @memory @email - Email with context awareness

Troubleshooting Shortcuts

Shortcut Not Working?

1. Check Permissions

   • Accessibility must be enabled
   • Some shortcuts need additional permissions

2. Conflicts

   • Other apps may use same shortcuts
   • Check System Settings → Keyboard → Shortcuts

3. Application-Specific Issues

   • Some apps override global shortcuts
   • Try alternative shortcuts

Reset to Defaults

1. Open Settings
2. Navigate to Shortcuts
3. Click "Reset All"
4. Confirm reset

Quick Reference Card

Practice Exercises

1. Basic Flow

   • Open launcher (⌘+Space)
   • Type a message
   • Close with ⌘+Q

2. Cancel Request

   • Open launcher
   • Send a complex query
   • While loading, press ⎋ to cancel

3. Expansion Practice

   • Create expansion for your name
   • Trigger it
   • Undo with ⌫

4. AI Command

   • Open launcher
   • Type "@email draft a thank you note"
   • Execute with ⏎

Next Steps

Now that you know the essential shortcuts:

• Explore text expansion features
• Learn about AI commands
• Customize your workflow

Remember: Efficiency comes with practice. Start with the launcher shortcut and expansion undo - these two will cover 80% of your daily usage!