STSora Tanaka
Productivity Writer
|Jan 27, 2026|11 min read|28.4K viewsAI Inside Your Command Bar
Create AI-powered commands that transform selected text, build quicklinks for instant URL launches, and chain commands for complex automations.
Raycast replaces Spotlight with a command bar that runs scripts, manages clipboard, controls windows, and even does AI — all from one hotkey.
By the end of this 11 min guide, you'll have a working Raycast setup and practical Raycast workflows you can use immediately.
- Understand what Raycast does and why it matters for Productivity
- Install and configure Raycast for your environment
- Build Raycast-specific workflows with real examples
- Troubleshoot common Raycast issues with concrete fixes
Configuring AI Models & API Keys
Install Raycast:
Download from raycast.com
- Productivity environment with appropriate permissions
- No prior Raycast experience needed
- A terminal with true color support
- Git for version-controlling your config
Tip: Verify the installation with raycast --version or raycast -V after installing.
Creating Custom AI Commands
Configure Raycast extensions in Settings. Script commands live in a directory you specify — any executable shell script with the right header becomes a searchable command.
Here's a foundational configuration to start with:
#!/bin/bash
# @raycast.title My Command
# @raycast.mode compact
echo "Hello from Raycast!"
- Begin with this config and make small, incremental changes
- Document each setting with inline comments
- Test changes one at a time to isolate issues
- Keep your config in a Git repo for easy rollback and sharing
Prompt Engineering for Quick Tasks
With Raycast configured, these Raycast-specific workflows will save you time every day:
Hyper+Space open Raycast- Script commands for quick CLI tasks
- Clipboard history with search and pinning
- Window snapping and layout management
- AI commands for instant text transformations
Pro tip: Don't try to adopt everything at once. Start with Hyper+Space open Raycast and add more as it becomes habit.
Quicklinks & AI Workflow
Once you're comfortable with Raycast basics, these advanced techniques will transform your Raycast workflow:
- Build full extensions with TypeScript and React
- Use Quicklinks for URL-based workflows
- Configure AI commands with custom prompts
- Set up deeplinks between commands
API & Rate Limit Issues
Here are the most common Raycast issues and how to fix them:
- Script not showing? Check it's executable:
chmod +x - PATH issues? Add
export PATH="/opt/homebrew/bin:$PATH" - No clipboard history? Enable in Settings → Clipboard
- AI not working? Check API key in Settings → AI
Your AI Productivity System
Congratulations — you now have a solid Raycast foundation. Here's where to go next:
- Explore the official Raycast documentation for features not covered here
- Join the Raycast community (GitHub Discussions, Discord, or Reddit)
- Check the related tutorials below for deeper Raycast dives
- Build your own Raycast configuration and share it with the community