Quickstart

Get up and running with Agentastic in just 5 minutes. This guide will walk you through installation, basic setup, and creating your first expansion.

Step 1: Installation

Download Agentastic

1. Visit the Agentastic download page
2. Download the latest version for macOS
3. Open the downloaded .dmg file
4. Drag Agentastic to your Applications folder

Grant Permissions

Agentastic requires Accessibility permissions to detect typing and inject expansions:

1. Open System Settings > Privacy & Security > Accessibility
2. Click the lock icon and authenticate
3. Enable Agentastic in the list
4. If prompted, restart Agentastic

Step 2: Launch Agentastic

1. Open Agentastic from your Applications folder
2. The app will appear in your menu bar (look for the icon in the top right)
3. Click the menu bar icon to access settings and controls

Step 3: Create Your First Expansion

Let's create a simple text expansion that types your email address:

1. Click the Agentastic menu bar icon
2. Select Settings or press ⌘,
3. Navigate to the Text Expansion tab
4. Click + Add Expansion
5. Fill in the details:
   • Trigger: eml (what you'll type)
   • Expansion: Your email address
   • Case Sensitive: Leave unchecked
6. Click Save

Now, try it out! Type eml in any application (like Notes or Messages), and watch it expand to your email address.

Step 4: Try AI-Powered Features

Agentastic's AI capabilities can help you write better and faster:

Quick AI Completion

1. Open the Agentastic launcher with ⌘⇧Space (or your configured shortcut)
2. Type a prompt like "Write a professional email about..."
3. Press Enter and watch the AI generate content

Using Special Tags

Try these special commands in the launcher:

• /email - Compose professional emails
• /search - Search the web or your files
• /calendar - Manage your schedule
• /agent - Enable advanced AI tools

Step 5: Customize Your Experience

Configure Shortcuts

1. Open Agentastic Settings
2. Go to Shortcuts tab
3. Customize keyboard shortcuts for:
   • Opening the launcher
   • Quick expansions
   • Toggle Agentastic on/off

Set Your Preferred AI Model

1. In Settings, go to AI Models
2. Choose your preferred model for different tasks
3. Configure API keys if using external models

Common First Steps

Create Essential Expansions

Here are some popular expansions to get started:

Learn the Basics

• Toggle Agentastic: Press your configured hotkey (default: ⌘⇧A)
• Open Launcher: Press ⌘⇧Space (customizable)
• Access Settings: Click menu bar icon → Settings or press ⌘,

Troubleshooting

Expansions Not Working?

1. Check that Agentastic has Accessibility permissions
2. Verify the app is running (icon in menu bar)
3. Ensure Agentastic is not disabled (check menu bar icon)

Need More Help?

• Read our detailed Installation Guide
• Check the Troubleshooting Guide
• Visit the Community Forum

What's Next?

Now that you're up and running, explore more features:

• Concepts - Understand how Agentastic works
• Models - Learn about AI model selection
• Core Features - Dive deeper into capabilities
• AI Commands - Master special tags and tools

Pro Tip: Start small with a few essential expansions, then gradually build your library as you discover repetitive typing patterns in your workflow.