Quick Links are one-click shortcuts to URLs or scripts.
Creating Quick Links:
- Open Raycast → “Create Quick Link”
- Name your link and enter URL
- Use dynamic variables in URLs
Dynamic Variables:
| Variable | Example | Behavior |
|---|---|---|
| {query} | https://google.com/search?q={query} |
Replaced with user input |
| {clipboard} | https://twitter.com/search?q={clipboard} |
Replaced with clipboard content |
| {selectedText} | https://www.youtube.com/results?search_query={selectedText} |
Replaced with selected text |
URL Scheme Examples:
raycast://confetti
raycast://dismiss
raycast://extensions
raycast://preferences
raycast://triggerCommand?commandName=Web%20Search&argument=hello
Snippets are text shortcuts that expand to longer content using Tab trigger.
Creating Snippets:
- ⌥Space → “Create Snippet”
- Set trigger text (e.g., “email”)
- Write snippet content
- Enable dynamic variables as needed
Dynamic Variables in Snippets:
| Variable | Description | Example |
|---|---|---|
| {date} | Today’s date | 2026-02-15 |
| {time} | Current time | 14:30 |
| {datetime} | Date and time | 2026-02-15 14:30 |
| {clipboard} | Clipboard content | Pastes current clipboard |
| {cursor} | Places cursor here | Leaves cursor at position |
| {name} | Your Mac name | Computer name |
Snippet Syntax Example:
Name: Meeting Notes
Trigger: @meeting
Content:
Meeting Date: {date}
Time: {time}
Attendees:
Notes:
[cursor here]
Script Commands let you run bash, Python, or Node.js scripts from Raycast.
Supported Languages:
- Bash/Shell
- Python 3
- Node.js
- Swift
- Zsh
Script Structure:
#!/bin/bash
# @raycast.schemaVersion 1
# @raycast.title My Script
# @raycast.description Does something cool
# @raycast.author bee
# @raycast.mode compact
# @raycast.icon 🚀
# @raycast.argument1 { "type": "text", "placeholder": "Enter text" }
echo "Hello $1"
Input Modes:
compact- Output shown in Raycast windowfullOutput- Opens dedicated windowsilent- No output window
Argument Types:
text- Plain text inputfile- File path pickerdirectory- Directory pickercheckbox- Boolean flagdropdown- Selection from list
Installing Extensions:
- ⌥Space → “Install Extension”
- Browse community extensions
- Click “Install” to add to Raycast
Creating Extensions (with React):
- Install Raycast CLI:
npm install -g @raycast/cli - Create extension:
raycast create extension - Build components in React
- Use Raycast UI library for consistency
- Test locally:
npm run dev
Publishing Extensions:
- Push to GitHub repository
- Submit to Raycast Store
- Automatic updates via Store
Popular Built-in Extensions:
- Clipboard History
- File Search
- Quick Links
- Snippets
- Floating Notes
- Calculator
- Timezone
- Weather
Confetti is a celebratory easter egg in Raycast.
Triggering Confetti:
- ⌥Space → Search “confetti”
- Press Enter to celebrate
- Works great for task completion
URL Scheme:
raycast://confetti
Pro Tip: Add “Confetti” as a quick link for celebration commands or embed in scripts for workflow celebrations.
Fallback Commands execute when you type something Raycast can’t match.
Setting Up Fallback:
- Open Preferences (⌘,)
- Go to “Extensions”
- Configure fallback command
- Choose: Web Search, Calculator, or Custom Script
Built-in Fallback Options:
- Web Search (default Google)
- Calculator (inline math)
- Custom script/command
Example: Custom Fallback Script
#!/bin/bash
# Fallback to DuckDuckGo search
open "https://duckduckgo.com/?q=$*"
Aliases provide quick access to commands using custom names.
Creating an Alias:
- Search for command in Raycast
- Press ⌘K to open actions
- Select “Create Alias”
- Enter alias name (e.g., “em” for email)
- Save
Example Aliases:
| Alias | Command |
|---|---|
| em | Send Email |
| ws | Web Search |
| calc | Calculator |
| notes | Create Note |
| kill | Kill Process |
Usage: Type alias directly in Raycast search to access command instantly.
Quick Links:
- Raycast feature
- URL with dynamic variables
- Command-line access
- Execute actions/scripts
- Perfect for: API calls, parameterized searches, automations
Bookmarks:
- Browser feature
- Simple URL shortcuts
- Access from browser
- No variables or logic
- Perfect for: Quick website access, browser toolbar
When to Use Each:
| Use Quick Link When | Use Bookmark When |
|---|---|
| Need URL variables | Simple website link |
| Want Raycast integration | Browser-centric workflow |
| Running scripts | Quick browser access |
| Frequently accessed | Occasional reference |
Example Quick Link:
Name: GitHub Search
URL: https://github.com/search?q={query}+language:markdown
Example Bookmark:
Name: GitHub
URL: https://github.com
Floating Notes provide quick capture of text without leaving current app.
Features:
- Always-on-top note window
- Markdown support
- Quick paste from clipboard
- Auto-save
- Keyboard shortcut (customizable)
Using Floating Notes:
- Open Raycast → “Floating Notes”
- Type or paste content
- Window stays on top while you work
- Content auto-saves
- Search notes anytime
Markdown in Floating Notes:
# Heading
- List items
**bold** text
[links](https://example.com)
Pro Tip: Pin important notes for easy access later.
Raycast includes built-in AI capabilities.
AI Features:
- Ask AI for general questions
- AI-powered commands
- Custom AI presets
- Summarize text
- Generate content
Quick AI Actions:
- Improve Writing
- Make Longer
- Make Shorter
- Professional Tone
- Friendly Tone
- Fix Spelling & Grammar
Custom AI Commands:
- Create Script Command
- Use Raycast API for AI
- Define prompt and instructions
- Set input/output format
Example AI Command:
#!/bin/bash
# @raycast.schemaVersion 1
# @raycast.title AI Prompt
# @raycast.argument1 { "type": "text" }
# Send to Raycast AI API
# Results appear in Raycast
Hotkey Per Command:
- Assign unique hotkey to any command
- Settings → Extensions → Select extension
- Click command and assign hotkey
- Use for frequently accessed commands
Navigation Tricks:
- Type to search instantly
- ↑↓ to navigate results
- → to open actions panel
- ← to go back
- Escape to close
Clipboard History Power:
- Search clipboard by content
- Pin frequently used items
- Delete sensitive items
- Sync across devices
File Search Pro Tips:
- Search by extension:
.pdf - Search by modification:
modified:1d - Combine with Quick Look (⌘Enter)
- Drag files into Raycast
Productivity Hacks:
- Create aliases for complex commands
- Chain Quick Links with snippets
- Use fallback for custom workflows
- Automate with Script Commands
- Integrate with other apps via URL schemes
Performance:
- Disable unused extensions
- Update Raycast regularly
- Clear clipboard history periodically
- Rebuild search index in preferences
| Shortcut | Action |
|---|---|
| ⌘← | Tile window to left half |
| ⌘→ | Tile window to right half |
| ⌘↑ | Maximize window |
| ⌘↓ | Minimize window |
| ⌘⌥← | Tile window to left third |
| ⌘⌥→ | Tile window to right third |
| ⌘⌥↑ | Center window |
| ⌘⌥M | Make window reasonable size |
| ⌘⌥Q | Quit all windows |
| Shortcut | Action |
|---|---|
| ⌥Space, then “Clipboard” | Open clipboard history |
| ⌘C | Copy selected item |
| ⌘V | Paste selected item |
| ⌥Space then “Pin” | Pin clipboard item |
| Delete | Delete clipboard item |
| ⌘Delete | Clear all clipboard history |
| Shortcut | Action |
|---|---|
| ⌥Space, type trigger | Search and expand snippet |
| ⌘N in Snippets | Create new snippet |
| ⌘E | Edit selected snippet |
| ⌘Delete | Delete snippet |
| Tab | Trigger snippet expansion in apps |
| ⌘⌥N | Create snippet from selection |
| Shortcut | Action |
|---|---|
| ⌥Space, type filename | Search for files |
| Enter | Open file with default app |
| ⌘Enter | Open in Quick Look |
| ⌥Enter | Reveal in Finder |
| ⌘C | Copy file path |
| ⌘Delete | Move file to trash |
| Tab | Show file actions |
| Shortcut | Action |
|---|---|
| ⌥Space, type math | Inline calculator (e.g., “123 + 456”) |
| ⌥Space, type units | Unit conversion (e.g., “100 km to miles”) |
| ⌥Space, type “timezone” | Timezone converter |
| Enter | Copy result to clipboard |
| ⌘C | Copy calculation |
| Shortcut | Action |
|---|---|
| ⌥Space, “Empty Trash” | Empty trash bin |
| ⌥Space, “Eject All” | Eject all mounted volumes |
| ⌥Space, “Lock Screen” | Lock screen immediately |
| ⌥Space, “Sleep” | Put Mac to sleep |
| ⌥Space, “Restart” | Restart Mac |
| ⌥Space, “Shutdown” | Shut down Mac |
| ⌥Space, “Toggle Dark Mode” | Switch appearance |
| ⌥Space, “Toggle Hidden Files” | Show/hide hidden files in Finder |
| ⌥Space, “Toggle WiFi” | Toggle WiFi on/off |
| ⌥Space, “Toggle Bluetooth” | Toggle Bluetooth on/off |
| Shortcut | Action |
|---|---|
| ⌥Space, “Install Extension” | Browse and install extensions |
| ⌥Space, “Quick Links” | Access quick links |
| ⌘, | Open Raycast preferences |
| ⌥Space, extension name | Search extension commands |
| Tab | Show extension actions |
| Shortcut | Action |
|---|---|
| ⌥Space, “Ask AI” | Open AI chat |
| ⌘Enter | Send message |
| ⌥Enter | Regenerate response |
| ⌘C | Copy AI response |
| ⌥Space, “AI Commands” | Access quick AI actions |
| ⌘K | Save conversation |