# Raycast Manual
> Raycast is a productivity launcher for Mac, Windows, and iOS. Use it to launch apps, search files, manage windows, expand snippets, chat with AI, and so much more, without ever leaving your keyboard. Discover how to use Raycast and get the most out of the app in this Raycast Manual.
This file contains the full public Raycast app manual in markdown format for Large Language Models and AI assistants.
## Basics
### Quickstart
Source: https://manual.raycast.com/quickstart
Description: New to Raycast? Start with this guide to get started with the basics of the app on Mac and Windows.
Last updated: 19 May 2026
New to Raycast? Start here. This guide walks you through downloading the app, searching your system, installing an extension, and having your first AI chat.
##### Download Raycast
Download Raycast, set your hotkey, then discover your shortcut to everything.
[Download Raycast](https://www.raycast.com/)
**System Requirements**
- Raycast for Mac: v2 **Beta** macOS Tahoe (Apple silicon)
- Raycast for Windows: **Beta** Windows 10 or later (x64 or ARM)
- Raycast for iOS: iOS 18 or later
##### Search Your System
Files, folders, and apps are searchable directly from Root Search. Press your Raycast hotkey, start typing, and open what you need instantly without opening Finder or File Explorer.
Read the [File Search page](https://manual.raycast.com/file-search) for more information.
##### Create a Snippet
Snippets are your personal library of reusable text, from saved email responses and code blocks to emojis and CLI commands. Open Raycast, type **Create Snippet**, give it a name, and use the keyword to paste snippet in any app.
Read the [Snippets page](https://manual.raycast.com/snippets) for more information.
##### Install an Extension
The Store is home to thousands of community-built extensions covering productivity, developer tools, communication, design, and more. Browse [**Store**](raycast://extensions/raycast/raycast/store) in Raycast or [on the web](https://raycast.com/store), install your favorite extensions, and find it in Root Search alongside your other commands.
Read the [Extensions page](https://manual.raycast.com/extensions) for more information.
##### Chat with Raycast AI
Raycast AI has two ways you can chat with AI. Press `Tab` from Root Search for **Quick AI**, ideal for fast one-off questions. For longer conversations, open **AI Chat** to ask follow-ups, share attachments, switch models mid-conversation, and pick up where you left off at any time.
Read the [Chat page](https://manual.raycast.com/ai/chat) for more information.
### Search Bar
Source: https://manual.raycast.com/search-bar
Description: The Raycast Search Bar and Root Search are where everything starts — search apps, files, commands, and extensions, then trigger actions with a press of a key.
Platforms: Mac, Windows
Last updated: 28 May 2026
The **Search Bar** is the single input at the top of the Raycast window, where everything starts. Type into it and Raycast searches across your Mac and extensions in real time.
**Root Search** is the list of results shown below the Search Bar when no command is open. It's Raycast's home screen and the entry point to everything you can do.
#### Compact Mode
When Compact Mode is enabled, the Raycast window collapses to show only the search bar when the search term is empty. The full results list expands as soon as you start typing or open the Action Panel. The window automatically collapses again when it loses focus.
You can enable Compact Mode in **Raycast Settings → General → Appearance → Window Mode**.
#### Action Panel
Every item in Root Search has an Action Panel (opened with `⌘`/`Ctrl` `K` or `Enter` on some items). The available actions vary by item type, but common actions include:
- **Add/Remove from Favorites**: Pin items for quick access.
- **New** **Assign Hotkey**: Set a keyboard shortcut to launch a command directly.
- **New** **Assign Alias**: Set a short keyword to quickly access a command.
- **Copy Deeplink**: Copy a direct link to the command for sharing or automation.
- **Disable Command**: Hide a command from Root Search results.
- **Reset Ranking**: Clear the frecency data for a command, resetting it to its default position in results.
#### Launch Apps
Raycast is a fast way to open any application installed on your system, no hunting through the Dock, Launchpad, or Start menu. Just open Raycast and start typing.
Hit your Raycast hotkey to focus the Search Bar, type the name of the app you want, and press `Enter` with it highlighted to launch it. Fuzzy search means you don't need an exact match, typing `msg` finds Messages, `slk` finds Slack.
> [!TIP]
> Pin the apps you use most as Favorites so they appear at the top of Root Search without typing. Open the Action Panel (`⌘`/`Ctrl` `K`) and choose **Add to Favorites**.
#### URL Detection
Raycast automatically detects when you type a valid URL into the search bar. When a URL is recognized, commands that can handle URLs (like web browsers and search commands) are surfaced. If you type a domain without a scheme, Raycast infers `https://` automatically.
#### File Navigation in Root Search
**New** Files and directories are now integrated directly into Root Search.
When File Search indexing is enabled, files and directories appear directly in Root Search results. You can also navigate the file system without leaving the search bar:
- `Tab`: Navigate into a directory (expand folder).
- `Shift` `Tab`: Navigate to the parent directory.
Recently used files also appear in the empty-search view, so you can quickly access files you've been working with.
#### Command Arguments
Some commands accept arguments (up to 3). When you select a command that has arguments, input fields appear right in the search bar area. Fill them in and press `Enter` to run the command with those parameters.
Navigate between argument fields with the `Left` and `Right` arrow keys. Arguments can be text, password, or dropdown types.
#### Search Contacts
_(Only on Mac)_
Use the **Search Contacts** command to find people from your Apple Contacts directly in Raycast. Open the command and start typing a name to filter your contacts in real time.
Once a contact is selected, use the Action Panel (`⌘ K`) to act on it: copy details, open in Contacts, etc. Make sure you enabled the Contact application in **Raycast Settings → Applications → Applications → Contacts**.
> [!TIP]
> Assign an alias or hotkey to **Search Contacts** so you can launch it straight from the Search Bar.
#### How Ranking Works
Root Search learns from you. The more often, and the more recently, you pick a result for a given query, the higher it ranks the next time you type the same thing.
> [!TIP]
> If two apps match what you type (say, `cal` could be Calendar or Calculator), Raycast notices which one you usually pick and starts surfacing that one first. Open the same app a handful of times via Root Search and it starts appearing at the top for shorter and shorter queries.
Ranking priority (from highest to lowest):
1. Exact alias match
2. Alias prefix match
3. Title fuzzy match score
4. Subtitle and keyword matches
5. Frecency (a blend of frequency and recency) score
If results feel out of order, you can use **Reset Ranking** from the Action Panel to clear learned behavior for a specific command.
#### What You Can Search For
Root Search surfaces a wide variety of items from across Raycast and your system. Here's everything you can find:
- **Applications**: All installed applications on your system. On macOS this includes symlinked apps; on Windows it covers Start Menu and desktop apps.
- **Commands**: Built-in Raycast commands and commands from installed extensions.
- **New****Files & Directories**: Indexed files and folders from your system. Recently used files appear when the search bar is empty.
- **New****Calendar Events**: Upcoming events for today appear at the top when the search bar is empty (requires calendar permissions).
- _(Only on Mac)_ **Search Contacts**: Find people from your Apple Contacts directly in Raycast.
- **Calculator**: Type a math expression (like `128 * 3.5`) and get instant results right in the search bar.
- **Quicklinks**: Saved quick links to URLs, files, or folders.
- **Snippets**: Text snippets that can be expanded.
- **AI Commands**: AI-powered commands and built-in AI prompts.
- **Script Commands**: Custom scripts you've set up.
- **Settings**: Raycast preferences and extension settings.
- **Web URLs**: Type a valid URL and Raycast detects it, offering actions like opening it in your browser.
- **Color Conversion**: type or paste any supported color value (e.g. `#FF6B35`, `rgb(255 107 53)`, `hsl(16 100% 60%)`, `oklch(0.7 0.18 40)`) in Root Search to see an instant visual preview, then copy it in the format you need.
> [!NOTE]
> Check the Search Bar placeholder text, it tells you what you can search for in the current context.
##### Search Sensitivity
You can adjust how strict the fuzzy search algorithm is in **Raycast Settings → Advanced → Root Search Sensitivity**. There are three levels:
- **High**: Requires more precise input. Best if you find too many irrelevant results.
- **Medium** (default): Balanced sensitivity for most users.
- **Low**: Returns broader results for any elements containing the typed letters. Best if you want maximum flexibility.
#### Favorites
Pin any command, application, or item as a **Favorite** to keep it at the top of Root Search when the search bar is empty.
- **Add to Favorites**: Open the Action Panel (`⌘`/`Ctrl` `K`) on any item and select "Add to Favorites".
- **Reorder Favorites**: Use "Move Favorite Up" or "Move Favorite Down" in the Action Panel to change the order.
- **Remove from Favorites**: Open the Action Panel on a favorited item and select "Remove from Favorites".
Favorites appear in a dedicated section above all other results, making your most-used items always just one keystroke away.
#### Aliases
Aliases are short, custom keywords you can assign to any command for quick access. For example, you could set `gc` as an alias for "Google Chrome".
- When you type an alias that exactly matches a command, that command is prioritized in results.
- Aliases appear as a tag next to the command name in the results list.
- If a command has arguments, typing the alias followed by a space will automatically focus the first argument field.
You can assign aliases from the Action Panel in Root Search or from extension settings.
#### Settings
You can customize Root Search behavior from **Raycast Settings**:
- **Raycast Settings → Advanced → Root Search Sensitivity**: Adjust fuzzy search strictness (Low / Medium / High).
- **Raycast Settings → General → Appearance → Window Mode**: Switch between standard and compact mode.
- **Raycast Settings → Advanced → Pop to Root Timeout**: How long before Raycast returns to Root Search when inactive.
- **Raycast Settings → File Search → Include Files in Root Search**: File Search Extension Settings: Configure whether files appear in Root Search, which directories to index, hidden files visibility, and ignore patterns.
- **Raycast Settings → Calculator → Color Conversion**: Enable to surface color results in Root Search. Detected colors can be copied in any supported format, including hex, rgb, hsl, oklch and other modern color spaces, plus NSColor and UIColor for Swift.
The Search Bar is the central hub of Raycast. It's focused by default whenever you open the app, so you can start typing immediately to find what you need. Whether it's an application, a command, a file, a calendar event, or a quicklink, everything is reachable from a single search.
> [!NOTE]
> Open Raycast with `⌘`/`Ctrl` `Space`. You can customize this shortcut in Settings (`⌘`/`Ctrl` `,`).
#### Keyboard Shortcuts
Raycast is built for keyboard-first workflows. Here are the most useful shortcuts for navigating the Search Bar.
##### Navigation
- `↑` / `↓`: Move up / down through results
- `⌘`/`Ctrl` `↑` / `⌘`/`Ctrl` `↓`: Jump to previous / next section
- `⌥`/`Alt` `↑` / `⌥`/`Alt` `↓`: Jump to previous / next page of results
- `Enter`: Run the selected item (primary action)
- `⌘`/`Ctrl` `Enter`: Run the secondary action
##### Search Bar
- `Escape`: Clear search text, or close Raycast if already empty
- `Backspace` (when search is empty): Navigate back
- `⌘`/`Ctrl` `K`: Open the Action Panel for the selected item
- `⌘`/`Ctrl` `,`: Open **Raycast Settings**
### Action Panel
Source: https://manual.raycast.com/action-panel
Description: The Action Panel surfaces every contextual action for the selected item in Raycast — open the Actopm Panel to discover, learn, and trigger actions right from your fingertips.
Platforms: Mac, Windows
Last updated: 29 April 2026
The Action Panel is one of Raycast's most powerful features. It lets you discover and execute actions on any selected item with just a few keystrokes, no mouse needed. Every item in Raycast, whether it's an application, a command, a file, or a calendar event, has an Action Panel with contextual actions tailored to it.
#### Opening the Action Panel
There are two ways to interact with actions:
- `⌘`/`Ctrl` `K`: Opens the full Action Panel, showing all available actions for the selected item. This is the best way to explore what you can do.
- `↵`: Triggers the **primary action** immediately (the first action in the list). For apps, this launches them. For commands, this runs them.
- `⌘`/`Ctrl` `↵`: Submits form data when you're in a form view.
- `Esc`: Closes the Action Panel or navigates back from a submenu.
> [!TIP]
> Make it a habit to press `⌘`/`Ctrl` `K` whenever you're unsure what actions are available. Each action shows its keyboard shortcut on the right, so you can learn to trigger them directly over time.
#### How the Action Panel is Organized
Actions are grouped into logical **sections** to make them easy to find. Each section groups related actions together. The exact sections depend on the item you've selected, but here's the typical layout:
##### Primary Action
The first action in the Action Panel is the **primary action**. It's displayed prominently at the top and is the action that runs when you press `↵` without opening the panel. For example:
- For an **application**, the primary action is "Open".
- For a **command**, the primary action is "Run Command".
- For a **file**, the primary action is "Open" or "Open With…".
##### Action Sections
Below the primary action, you'll find additional sections. Common ones include:
- **Favorites**: Add/remove from favorites, reorder favorites.
- **Configure**: Open command settings, set hotkey, set alias, configure extension.
- **Deeplink**: Copy a direct link to the command.
- **Manage**: Disable command, reset ranking.
#### Searching for Actions
When the Action Panel is open, you'll see a search field at the top with the placeholder *"Search for actions…"*. Start typing to filter actions by name in real-time using fuzzy matching. This is especially useful when an extension provides many actions and you want to jump to a specific one quickly.
When searching, all matching actions are shown in a single flat list regardless of their original sections.
#### Sub-menus
> [!NOTE]
> **New** Actions can now open sub-menus and custom views.
Some actions don't execute immediately. They open a **sub-menu** with additional options. For example, "Configure Command" opens a sub-menu where you can set a hotkey, set an alias, open settings, or delete existing configurations.
Some sub-menu items open **custom views** directly inside the Action Panel. For instance, "Set Hotkey" opens an inline keyboard shortcut recorder where you can press your desired key combination and save it, all without leaving the Action Panel.
Press `Esc` to go back from a sub-menu to the main Action Panel.
#### Configuring Commands from the Action Panel
> [!NOTE]
> **New** You can now assign hotkeys and aliases directly from Root Search without going to Settings.
Select any command in Root Search and open the Action Panel. Under the **Configure Command** section, you'll find:
##### Set Hotkey
Opens an inline keyboard shortcut recorder. Press the key combination you want to assign, then confirm with `↵`. The recorder shows:
- The command name and icon for context
- A "Press keys to assign" prompt
- The currently assigned hotkey (if one exists)
- A clear button to remove the existing hotkey
##### Set Alias
Opens a text input field where you can type a short keyword as an alias for the command. Once set, typing that alias in Root Search will prioritize the command in results.
##### Other Configure Options
- **Open Command Settings**: Opens the full settings page for the command.
- **Configure Extension**: Opens the extension's settings page.
- **Delete Hotkey / Delete Alias**: Removes the assigned hotkey or alias (only visible when one is set).
#### Common Actions Reference
Here are the common actions you'll find across most items in Root Search:
##### Favorites
- **Add to Favorites** (`⌘`/`Ctrl` `F`): Pin the item so it always appears at the top of Root Search.
- **Remove from Favorites**: Unpin a previously favorited item.
- **Move Favorite Up / Down** (`⌘`/`Ctrl` `↑` / `⌘`/`Ctrl` `↓`): Reorder your favorites.
##### Configuration
- **New** **Configure Command** (`⌘`/`Ctrl` `⇧` `,`): Opens a sub-menu with Set Hotkey, Set Alias, and settings options.
- **Configure Extension** (`⌘`/`Ctrl` `⇧` `,`): Opens extension-level settings.
- **Disable Command** (`⌘`/`Ctrl` `⇧` `D`): Hides the command from Root Search results. You can re-enable it from the extension settings.
##### Deeplinks & Sharing
- **Copy Deeplink**: Copies a direct URL to the command to your clipboard. Useful for sharing workflows, creating automation triggers, or adding to documentation.
##### Managing Commands
- **Reset Ranking**: Clears learned frecency data and search terms for a command, resetting it to its default position. Useful if a command appears too high or too low in your results.
#### Actions by Item Type
The Action Panel adapts to the type of item you've selected. In addition to the common actions above, here are some examples of what you'll see for specific item types:
- **Applications**: Open, Show in Finder, Uninstall (if supported), Hide/Unhide from Root Search.
- **Files & Directories**: Open, Open With…, Show in Finder, Copy Path, Move to Trash.
- **Calendar Events**: Open in Calendar, Join Meeting (if a link is available), Copy Event Details.
- **Extension Commands**: Run Command, plus any custom actions defined by the extension developer.
The best way to discover what's available is to press `⌘`/`Ctrl` `K` on any item and explore.
#### Extension-Defined Actions
When you're inside an extension command (not Root Search), the Action Panel shows actions defined by the extension developer. These can include anything the extension needs: copying values, opening URLs, navigating between views, running scripts, and more.
Extension developers can:
- Define custom actions with icons, titles, and keyboard shortcuts.
- Organize actions into named sections.
- Create sub-menus for complex action hierarchies.
- Mark actions as **destructive** (shown in red) to warn users before irreversible operations.
#### Keyboard Shortcuts
- `↵`: Run primary action
- `⌘`/`Ctrl` `K`: Open Action Panel
- `⌘`/`Ctrl` `↵`: Submit form
- `Esc`: Close panel / go back
- `⌘`/`Ctrl` `⇧` `F`: Add to Favorites
- `⌘`/`Ctrl` `⇧` `,`: Configure Command
- `⌘`/`Ctrl` `⌥`/`Alt` `,`: Configure Extension
- `⌘`/`Ctrl` `⌃`/`Alt``⇧` `D`: Disable Command
### Command Aliases & Hotkeys
Source: https://manual.raycast.com/command-aliases-and-hotkeys
Description: Instantly activate any Raycast command by setting up custom aliases or assigning hotkeys. Launch your favorite actions with a quick keyword or keyboard shortcut, without searching or breaking your flow.
Platforms: Mac, Windows
Last updated: 17 May 2026
Aliases and hotkeys let you launch any Raycast command faster. An **alias** is a short keyword you type into Root Search to jump straight to a command. A **hotkey** is a global keyboard shortcut that launches a command from anywhere on your system, even when Raycast isn't open.
#### Command Aliases
##### What is an Alias?
An alias is a custom short keyword that you assign to a command. When you type the alias into Root Search, the associated command is immediately prioritized in the results. For example, you could set `gc` as an alias for Google Chrome, or `cb` for Clipboard History.
Aliases appear as a small badge next to the command name in Root Search results, so you can always see which commands have aliases assigned.
##### How to Set an Alias
There are two ways to assign an alias:
**From the Action Panel**
**New** You can now set aliases directly from Root Search without opening Settings.
1. Select a command in Root Search.
2. Press `⌘`/`Ctrl` `,` or open the Action Panel (`⌘`/`Ctrl` `K`) and choose **Configure Command**.
3. Select **Set Alias**.
4. Type your desired alias and press `↵` to save.
**From Settings**
1. Open **Raycast Settings → Shortcuts**.
2. Find the command you want (use the search bar or filters to narrow the list).
3. Click the alias field (shows "Add Alias" as placeholder) and type your alias.
4. Press `↵` or click away to save.
##### How Aliases Work in Root Search
Aliases use strict matching in Root Search, which makes them more predictable than regular fuzzy search:
- **Exact match**: Typing the full alias (e.g. `gc`) places the command at the very top of results. This has the highest ranking priority.
- **Prefix match**: Typing the beginning of an alias (e.g. `g` for `gc`) still boosts the command in results, but lower than an exact match.
- **Alias + space**: If a command has arguments, typing the alias followed by a space focuses the first argument field automatically.
> [!TIP]
> Aliases don't use fuzzy matching. They use strict prefix matching, which means they're always predictable. This makes them ideal for muscle-memory workflows.
##### Alias Format
- Allowed characters: lowercase letters (a–z), numbers (0–9), and spaces.
- Aliases are automatically converted to lowercase when saved.
- Spaces in aliases are displayed as `␣` in the UI for clarity (e.g. `go␣compose`).
- Aliases can be single or multi-word.
- Special characters are not supported.
##### Changing or Removing an Alias
- **To change**: Edit the alias field (in Settings or via Action Panel → Configure Command → Set Alias) and type the new value.
- **To remove**: Clear the alias field entirely, or use Action Panel → Configure Command → Delete Alias.
Changes take effect immediately. No confirmation dialog or restart needed.
#### Hotkeys
##### What is a Hotkey?
A hotkey is a global keyboard shortcut that launches a Raycast command from anywhere on your system. Unlike aliases (which require Root Search to be open), hotkeys work even when Raycast is in the background. Press the key combination, and the command runs immediately.
Assigned hotkeys are displayed next to the command name in Root Search when the command is selected, using platform-appropriate symbols.
##### How to Set a Hotkey
There are two ways to assign a hotkey:
**From the Action Panel**
**New** You can now record hotkeys directly from Root Search without opening Settings.
1. Select a command in Root Search.
2. Press `⌘`/`Ctrl` `,` or open the Action Panel and choose **Configure Command**.
3. Select **Set Hotkey**.
4. The keyboard shortcut recorder opens. Press the key combination you want to assign.
5. The hotkey auto-saves after a short countdown, or press `↵` to save immediately.
**From Settings**
1. Open **Raycast Settings → Shortcuts**.
2. Find the command and click **Record Hotkey**.
3. Press your desired key combination in the recorder popover.
4. Save with `↵` or wait for auto-save.
##### The Hotkey Recorder
**New** A redesigned, visual keyboard shortcut recorder with auto-save and real-time conflict detection.
When you record a hotkey, a popover appears with a visual key recorder. Here's what you'll see:
- **Real-time key display**: As you press keys, they appear as styled keyboard buttons in the recorder, so you can see exactly what you're recording.
- **Auto-save with countdown**: Once a valid combination is entered, a visual progress bar counts down (~1.5 seconds) before auto-saving. You can press `↵` to save immediately.
- **Conflict warnings**: If the combination conflicts with another command, the recorder highlights in red and shows which command owns the shortcut.
- **Clear button**: Click the `✕` button to remove the current hotkey, or press `Backspace` while recording to clear.
##### Supported Key Combinations
A hotkey is typically a modifier key (or combination of modifiers) plus a regular key.
**Modifier Keys**
_(Only on Mac)_ `⌘`, `⌃`, `⌥`, `⇧`, **New** `GlobeIcon` `fn`
_(Only on Windows)_ `Ctrl`, `Alt`, `⇧`, `Win`
**New** You can switch between left and right modifier keys or select both by clicking on the key in the hotkey recorder. If a left or right modifier is recorded, you will see a small **L** or **R** next to the modifier.
**Regular Keys**
Letters (A–Z), numbers (0–9), function keys (F1–F24), punctuation (`. , ; = - [ ] / \`), and special keys (Return/Enter, Tab, Escape, Delete, Arrows, Home, End, Page Up/Down).
##### Hotkey Types
**New** To give you a wider range of hotkey options we support a few different hotkey types:
###### Single Step
This is when you record your hotkey with one press of each key in the sequence. For example `⌥` `⌘` `A` on Mac or `Ctrl` `⇧` `L` on Windows
###### Double-Tap Modifiers
**New** You can record a hotkey using a double-tap modifier: just two quick presses of a modifier key. For example you could record a hotkey as `⌘`/`Ctrl` `⌘`/`Ctrl`.
###### Single Key
**New** A single press of certain keys can launch a command, no modifiers needed.
- _(Only on Mac)_ You can assign the `fn` key (shown as Globe key) as a single-tap hotkey. Users with an extended keyboard layout can also assign `F13`–`F18` as single-tap hotkeys.
- _(Only on Windows)_ You can assign the `Win` key as a single-tap hotkey.
These keys can also be combined with other keys for more complex shortcuts, such as `fn` `A`, `fn` `Ctrl` `A`, `F13` `⌘`, or `Win` `A`.
##### Support for International Keyboards
**New** You can now choose to record hotkeys as either physical keys or key equivalents, making it easier to switch between different keyboard layouts.
- **Physical Key**: The hotkey stays on the same key position across different layouts. For example, a hotkey recorded with the `Z` key on a QWERTZ keyboard corresponds to the `Y` key on a QWERTY keyboard.
- **Key Equivalent**: The hotkey maps to the same character regardless of layout. For example, a hotkey recorded with `Z` on a QWERTZ keyboard remains `Z` when switched to a QWERTY layout.
By default, all hotkeys are recorded as phyical keys. You can configure this for each key. To do this:
1. Open the hotkey recorder from Settings or via Root Search.
2. Record your hotkey if one is not already set.
3. Click on the key you wish to change.
4. No blue dot on the key means it was recorded as a physical key. A blue dot indicates it was recorded as a key equivalent.
> [!NOTE]
> All built-in Raycast shortcuts use key equivalent keys, and this setting cannot be changed.
##### Conflict Detection & Overwrites
**New** Improved conflict detection with the ability to overwrite conflicting shortcuts.
The hotkey recorder automatically detects conflicts at two levels:
**Raycast Global Shortcut Conflict**
If you try to assign a combination that's already used as Raycast's main launcher shortcut, you'll see an error: "Already used by Raycast." This type of conflict cannot be overwritten.
**Command Conflict**
If you try to assign a combination already used by another command, the recorder shows the conflicting command's name and icon with a red warning. You have two options:
- **Choose a different combination**: Press new keys to try a different shortcut.
- **Overwrite**: Save the shortcut anyway. The conflicting command loses its hotkey, and your new command takes over. The previous command will need to be reassigned if you still want it to have a hotkey.
##### Removing a Hotkey
- Click the `✕` button next to the hotkey display in Settings or the recorder.
- Or open the recorder and press `Backspace` to clear, then save.
- Or use Action Panel → Configure Command → Delete Hotkey.
The hotkey is removed immediately and the global shortcut stops working.
#### Managing Aliases & Hotkeys
##### The Shortcuts Settings Page
**New** You can manage all your aliases and hotkeys from a single place: **Raycast Settings → Shortcuts**.
This page provides:
- **A complete list** of all commands with their aliases and hotkeys visible inline.
- **Search** to quickly find a specific command.
- **Filters** to narrow the view by category (Applications, Extensions, Quicklinks, System Actions, etc.) or by status (*Hotkey Set*, *Alias Set*, *Enabled*, *Disabled*).
- **Inline editing**: Click on any alias or hotkey field to edit it directly in the list.
> [!TIP]
> Use the "Hotkey Set" or "Alias Set" filter to see all commands that already have shortcuts assigned. This is a great way to audit your setup and avoid conflicts.
##### Aliases vs. Hotkeys: When to Use Which
Both aliases and hotkeys speed up your workflow, but they serve different purposes:
- **Use an alias** when you want faster access to a command within Raycast. Aliases are great for commands you use often but not constantly: you open Raycast, type 2–3 characters, and you're there. They're easy to remember and you can have many without worrying about conflicts.
- **Use a hotkey** when you want instant access from anywhere on your system without opening Raycast first. Hotkeys are ideal for commands you trigger dozens of times a day, like clipboard history, window management, or your most-used translation pair. Since they're global, keep the number manageable to avoid conflicts.
- **Use both** for commands that you want to access both ways. A command can have an alias and a hotkey at the same time.
### Keyboard Shortcuts
Source: https://manual.raycast.com/keyboard-shortcuts
Description: Explore the Raycast keyboard shortcut on Mac and Windows. Learn how to launch commands, navigate search, trigger actions, manage windows, and streamline your workflow with speed.
Platforms: Mac, Windows
Last updated: 29 April 2026
Raycast is built to be driven entirely from the keyboard. This page lists all the keyboard shortcuts available across the app. Learning even a few of these will significantly speed up your workflow.
> [!TIP]
> On macOS, Raycast uses `⌘` (Cmd) as the primary modifier. You can also enable Emacs-style or Vim-style navigation bindings in Settings.
#### Global Shortcuts
These shortcuts work from anywhere on your system, even when Raycast isn't in focus.
- `⌘`/`Alt` `Space`: Open or close Raycast (default, can be customized).
You can also assign custom global hotkeys to any command. See the **Command Aliases & Hotkeys** page for details.
#### General Navigation
These shortcuts work across most views in Raycast.
- `Esc`: Go back to the previous view. From Root Search, closes the Raycast window.
- `⌘`/`Ctrl` `Esc`: Pop to Root.
- `⌘`/`Ctrl` `W`: Close the Raycast window.
- `⌘`/`Ctrl` `,`: Open **Raycast Settings**.
- `⌘`/`Ctrl` `⇧` `/`: Open the User Guide.
#### List Navigation
These work in any list view: Root Search, extension results, Action Panel, etc.
- `↑` `↓`: Move up and down in the list.
- `⌥`/`Alt` `↑` / `⌥`/`Alt` `↓`: Jump to the previous or next page of results.
- `⌘`/`Ctrl` `↑` / `⌘`/`Ctrl` `↓`: Jump to the previous or next section.
- `Ctrl` `N` / `Ctrl` `P`: Move down / up (Emacs-style, enabled by default).
> [!NOTE]
> Pagination keys can be changed in **Raycast Settings → Keyboard → Page Navigation Keys**.
#### Root Search
These shortcuts work in Raycast's main search.
- `↵`: Run the primary action.
- `⌘`/`Ctrl` `K`: Open the Action Panel.
- `Tab`: **New** Navigate into a directory.
- `⇧` `Tab`: **New** Navigate to parent directory.
- `↑` / `↓` (at top/bottom of list): **New** Cycle through search history.
- `⌘`/`Ctrl` `F`: Add the selected item to Favorites.
- `⌘`/`Ctrl` `⇧` `↑` / `⌘`/`Ctrl` `⇧` `↓`: Move a favorite item up or down.
- `⌘`/`Ctrl` `,`: **New** Configure Command.
- `⌘`/`Ctrl` `⇧` `,`: Configure Extension.
- `⌘`/`Ctrl` `⇧` `D`: Disable Command.
#### Action Panel
These shortcuts work inside the Action Panel.
- `⌘`/`Ctrl` `K`: Open or close the Action Panel.
- `↵`: Execute the selected action.
- `⌘`/`Ctrl` `↵`: Execute the secondary action.
- `⌘`/`Ctrl` `⇧` `↵`: Execute the tertiary action.
- `Esc`: Close the Action Panel or go back from a sub-menu.
- Type to search: **New** Filter actions by name when the panel is open.
#### Common Item Actions
These shortcuts work on selected items across most views. Not all actions are available for every item type.
- `⌘`/`Ctrl` `O`: Open item.
- `⌘`/`Ctrl` `⇧` `O`: Reveal in Finder / File Explorer.
- `⌘`/`Ctrl` `⌥`/`Alt` `O`: Open With…
- `⌘`/`Ctrl` `Y`: Toggle Quick Look preview.
- `⌘`/`Ctrl` `E`: Edit item.
- `⌘`/`Ctrl` `I`: Show info / details.
- `⌘`/`Ctrl` `D`: Duplicate item.
- `⌘`/`Ctrl` `.`: Pin or unpin item.
- `⌘`/`Ctrl` `⇧` `.`: Show hidden items.
##### Copy & Paste
- `⌘`/`Ctrl` `C`: Copy.
- `⌘`/`Ctrl` `⇧` `C`: Copy (secondary, e.g. copy deeplink).
- `⌘`/`Ctrl` `V`: Paste.
- `⌘`/`Ctrl` `⇧` `V`: Paste (secondary).
##### Delete
- `Ctrl` `X`: Delete selected item.
- `Ctrl` `⇧` `X`: Delete all.
#### AI Chat
**New** AI Chat has a full set of dedicated keyboard shortcuts.
##### Chat Navigation
- `⌘`/`Ctrl` `⇧` `S` or `⌘`/`Ctrl` `B`: Toggle chat history sidebar.
- `⌘`/`Ctrl` `⇧` `F`: Search chats.
- `⌘`/`Ctrl` `J`: Send selected item to AI Chat (from other views).
##### Composer & Messages
- `⌘`/`Ctrl` `⇧` `A`: Add attachment to composer.
- `⌘`/`Ctrl` `⇧` `B`: Branch chat from a message.
##### Model & Settings
- `⌘`/`Ctrl` `⇧` `M`: Change AI model.
- `⌘`/`Ctrl` `⇧` `Y`: Change creativity level.
- `⌘`/`Ctrl` `⇧` `U`: Change reasoning effort.
##### Chat Management
- `⌘`/`Ctrl` `⌥`/`Alt` `A`: Archive chat.
- `⌘`/`Ctrl` `⌃`/`Alt` `N`: Create folder.
- `⌘`/`Ctrl` `⌃`/`Alt` `M`: Move to folder.
##### Feedback
- `⌘`/`Ctrl` `⇧` `=`: Upvote / Good response.
- `⌘`/`Ctrl` `⇧` `-`: Downvote / Bad response.
#### Forms
These shortcuts work inside Raycast forms.
- `⌘`/`Ctrl` `↵`: Submit the form.
- `Tab`: Move to the next field.
- `⇧` `Tab`: Move to the previous field.
- `Esc`: Cancel and go back.
#### Text Editing
Standard text editing shortcuts work in all text fields.
- `⌘`/`Ctrl` `A`: Select all.
- `⌘`/`Ctrl` `C`: Copy.
- `⌘`/`Ctrl` `X`: Cut.
- `⌘`/`Ctrl` `V`: Paste.
- `⌘`/`Ctrl` `Z`: Undo.
- `⌘`/`Ctrl` `⇧` `Z`: Redo.
#### Alternative Navigation Bindings
Raycast supports alternative navigation styles that you can enable in Settings. These provide familiar keybindings for users coming from terminal editors.
##### Emacs Bindings (enabled by default)
- `Ctrl` `N`: Move down.
- `Ctrl` `P`: Move up.
- `Ctrl` `F`: Move right.
- `Ctrl` `B`: Move left.
##### Vim Bindings (optional)
- `Ctrl` `J`: Move down.
- `Ctrl` `K`: Move up.
- `Ctrl` `L`: Move right.
- `Ctrl` `H`: Move left.
You can switch navigation bindings in **Raycast Settings → Keyboard → Navigation Bindings**.
#### Extensions Support & Feedback
These shortcuts open extension support and feedback options.
- `⌘`/`Ctrl` `⇧` `B`: Report a bug.
- `⌘`/`Ctrl` `⌥`/`Alt` `F`: Request a feature.
### Import & Export
Source: https://manual.raycast.com/import-export
Description: Easily back up, transfer, or migrate your full Raycast setup and data between your devices.
Platforms: Mac, Windows
Last updated: 13 May 2026
Use Import & Export to move your Raycast setup between machines, create a backup for safekeeping, or migrate your data from Raycast for Mac v1. Export your entire configuration as a single file, or export individual components like Snippets and Quicklinks and import them into Raycast on another machine.
#### Exporting
##### Export Settings & Data
When you export using the **Export Settings & Data** command in Raycast on Mac or Windows, Raycast bundles eleven data categories into a single `.rayconfig` file saved to your computer. The following categories are included:
- AI Chats, Commands & Agents
- Clipboard History
- Quicklinks
- Snippets
- Notes
- Emoji & Symbol History
- MCP Servers
- Extensions installed from the Store
- Settings, Aliases & Hotkeys
- Raycast Wrapped
- Window Management Layouts
`.rayconfig` files are encrypted and require a passphrase of at least 8 characters. You'll be prompted to set one the first time you use the **Export Settings & Data** command, or in **Raycast Settings → Advanced → Export**. Raycast remembers it for future exports. You can clear or update it in Settings at any time.
##### Export Snippets or Quicklinks
To export just your Snippets or Quicklinks, use the **Export Snippets** and **Export Quicklinks** commands to save each as a JSON file. Snippet and Quicklink exports are not encrypted and do not require an export passphrase.
##### Scheduled Exports
Raycast can automatically export your data on a schedule, so you always have a recent backup without having to think about it. To set it up:
1. Open **Raycast Settings → Advanced → Export**.
2. Set an export passphrase of at least 8 characters. Backups will be skipped if no valid passphrase is set.
3. Choose a backup frequency (**None**, **Daily**, **Weekly**, or **Monthly**) and an output folder.
- Optionally, enable **Auto-Delete Old Exports** to manage disk space. You can keep the latest, last 5, or last 10 exports.
Once configured, a `.rayconfig` file will be saved to your chosen folder at the scheduled frequency.
> [!TIP]
> Point **Scheduled Backup Location** at a synced folder like iCloud Drive, Dropbox, or Google Drive. The `.rayconfig` is encrypted with your passphrase, so your data stays private while you get an off-machine copy automatically.
#### Importing
##### Import Settings & Data
Import `.rayconfig` files into Raycast using the **Import Settings & Data** command. You'll see a checklist of all available categories and can pick exactly which ones to import. Any unchecked categories are left untouched.
`.rayconfig` files are cross-platform. A file exported from Raycast on Mac v2 can be imported into Raycast on Windows, and vice versa. This makes it straightforward to carry your setup across platforms without any extra steps.
> [!TIP]
> Imports are selective. If you only want to recover your Snippets from an earlier backup, import the `.rayconfig` and tick only **Snippets** in the category checklist.
##### Import Snippets or Quicklinks
Import your Snippets and Quicklinks using the **Import Snippets** and **Import Quicklinks** commands to load each from a JSON file.
##### Migrate from Raycast v1
> [!WARNING]
> Make sure that you are running Raycast for Mac v1.104.16 or newer if you would like to migrate data from Raycast v1 to v2.
If you've previously used Raycast v1 on Mac, you can migrate your data directly to Raycast v2. No `.rayconfig` file is needed. The first time you launch v2 on a Mac where v1 is installed, you'll be prompted to transfer automatically.
If you'd prefer to migrate later, dismiss the onboarding screens and run the **Migrate from Raycast v1** command. This command brings across some extra data that is not included in your `.rayconfig` export, namely Clipboard History, Wrapped and your Emoji Picker customizations.
If you include **Settings, Aliases & Hotkeys**, Raycast will show a **Transfer Hotkeys?** prompt. Confirming will disable those hotkeys in v1 so both apps aren't competing for the same shortcuts. You can re-enable them in v1 at any time.
> [!TIP]
> Migration is additive — your existing v2 setup is never wiped. Duplicates, like a Quicklink with the same link or a Snippet with the same keyword, are skipped automatically.
If you don't need the extra data and are okay with manually reconfiguring your hotkeys, then using the Import Settings and Data command with your `.rayconfig` file is also an option.
##### Conflict Handling
Raycast handles duplicates automatically when you import. Here's what to expect:
- Quicklinks with an existing matching link are skipped.
- Snippets that match an existing text, keyword, and name are skipped. Keyword collisions are also skipped.
- All other data merges with your existing setup. Nothing is overwritten.
### Settings
Source: https://manual.raycast.com/settings
Description: Manage your Raycast settings. Set up keyboard shortcuts, themes, AI providers, and extensions to fit your workflow.
Platforms: Mac, Windows
Last updated: 04 June 2026
Settings is where you personalize Raycast to fit your workflow. From appearance and hotkeys to AI configuration and extension management, everything is accessible from a single, streamlined interface. In v2, Settings has been redesigned with a cleaner layout that matches the refreshed look and feel of the app.
> [!TIP]
> Open Settings quickly by pressing `⌘`/`Ctrl` `,` while Raycast is open, or search for "Settings" in Root Search.
#### Opening Settings
There are several ways to access Settings:
- Type **Settings** in Root Search.
- Press `⌘`/`Ctrl` `,` when Raycast is open.
- Select any command in Root Search, open the Action Panel (`⌘`/`Ctrl` `K`), and choose **Configure Command** or **Configure Extension**.
- Press `⌘`/`Ctrl` `⇧` `,` from Root Search to jump directly to the selected item's settings.
#### Account
The Account tab sits at the top left of Settings and shows your profile at a glance. Simply click on your display name to manage your Raycast account, view your current plan (Free, Pro, or Teams), and access subscription settings. You can also sign in or sign out of your account, and switch between organizations if you belong to more than one.
#### General
The General tab contains the core options that shape your everyday Raycast experience.
##### Open at Login
Choose whether Raycast launches automatically at login. We recommend keeping this enabled so Raycast is always ready when you need it.
##### Show in Menu Bar
Toggle whether Raycast appears in the menu bar. When enabled, you can quickly access Raycast settings, check for updates, and quit the app from the menu bar icon.
##### Raycast Hotkey
Set the global keyboard shortcut that opens Raycast from anywhere on your computer. The default is `⌥`/`Alt` `Space`. On macOS, you can replace Spotlight by assigning `⌘` `Space` to Raycast for an even more seamless experience.
##### Appearance
Control the visual presentation of Raycast.
##### Follow System Appearance
Raycast adopts your system's light or dark mode by default. Toggle this off to manually choose a theme. Raycast ships with a curated set of built-in themes, and you can browse and install community themes from the Store.
##### Window Mode
Choose between Compact and Expanded mode. Compact mode uses a more condensed layout so you can see more results at a glance.
#### Launcher
_(Only on Mac)_
The top of the Launcher tab is where you fine-tune the everyday launcher behavior.
 Set which screen Raycast opens on, how it pops to root search after sitting idle, and dial Root Search to surface more results or only the closest matches.
##### Customize Search
Choose whether to include Files and Contacts in Root Search, alongside your apps, commands, and extensions.
##### Fallback Commands
**New** Configure which commands appear at the bottom of Root Search results when your query has no matches. Add commands from any extensions, use **the drag handle** to reorder them, and use **the minus button** to remove ones you don't want.
#### Shortcuts
**New** The Shortcuts tab gives you a bird's-eye view of every shortcut assigned across Raycast. You can filter by category and see which commands already have hotkeys or aliases. This is the central place to manage all your shortcuts at a glance, rather than navigating into individual extension tabs.
You can also assign shortcuts from each extension's dedicated tab in Settings, or directly from the Action Panel in Root Search.
**New** You can now assign hotkeys and aliases directly from the Action Panel in Root Search, no need to open Settings first.
**New** The hotkey recorder has been completely rebuilt with support for single-tap `fn` key on macOS and `Win` on Windows as a modifier, improved conflict detection, and the ability to overwrite conflicting shortcuts.
**New** You can now assign left and right modifier keys as hotkeys. Simply click on the key when you set it up in **Raycast Settings > Shortcuts**
#### Keyboard
The Keyboard tab lets you customize how you navigate within Raycast using your keyboard.
##### Emacs & Vim Key Bindings
Enable Emacs-style (`Ctrl` `N` / `Ctrl` `P`) or Vim-style navigation for moving through lists and text fields within Raycast.
##### Navigation
Fine-tune search and navigation behavior, such as whether pressing `Esc` returns to Root Search or closes Raycast entirely.
#### Advanced
The Advanced tab provides additional configuration for power users.
##### Window Behavior
Configure how the Raycast window behaves:
- **Auto-close on focus lost**: choose whether Raycast hides when you click away
- **Return to Root Search**: set when Raycast resets to the main search view (immediately, after a delay, or never)
- **Window position on multi-monitor setups**: Raycast opens on the display that currently has keyboard focus
##### Export & Import Settings
Export your full Raycast configuration to a file and import it on another machine. This transfers your extensions, hotkeys, aliases, and preferences so you can set up a new machine quickly.
> [!TIP]
> If you use Raycast on multiple machines, export your settings periodically so you always have a recent backup available.
##### HTTP Proxy
If your network requires a proxy, configure it here. Raycast will route its network traffic through the specified proxy server.
#### Organizations
If you are part of a Raycast Teams plan, the Organizations tab lets you view and manage your team membership. You can see which organization you belong to, switch between organizations, and access team-specific settings and policies configured by your admin.
#### About
The About tab shows your current Raycast version number, provides links to the Raycast website and changelog, and lets you submit feedback or bug reports. You can also check for updates here.
#### AI
The AI settings are where you configure how Raycast AI works for you — agents, commands, extensions, memory, and the general behavior of AI Chat and Quick AI. Toggle the switch in the top right to enable or disable AI globally.
##### Agents, AI Commands & AI Extensions
Three sub-panes manage everything you can build on top of AI:
- **[Agents](https://manual.raycast.com/ai/agents)**: Your custom AI agents, each with their own instructions, tools, and personality.
- **[AI Commands](https://manual.raycast.com/ai/ai-commands)**: Reusable prompts you can trigger anywhere in Raycast (translate, summarize, fix grammar, etc.).
- **[AI Extensions](https://manual.raycast.com/ai/ai-extensions)**: Extensions that AI can call as tools when answering you, letting it take real actions across your apps.
##### Personalization
###### Profile
Add context you want available in every conversation — your role, the tools you use, how you'd like AI to respond. The profile applies to AI Chat and Quick AI, but not to AI Commands (which run with their own dedicated prompts).
###### Memory
When Memory is on, Raycast keeps a running summary of details from your conversations and reuses them automatically. Just tell it what to remember in any chat — for example, *"Remember I'm vegetarian."*
Use **Show Memory** to review or edit what's stored, or **Import** to bring in memory from another source.
##### General
- **Start New Chat** — how long Quick AI waits before starting a fresh conversation when you reopen it. Default is **After 5 minutes**.
- **Send Message** — the keyboard shortcut used to send messages in AI Chat. Default is **⌘ Return**.
- **Conversation History** — choose whether AI Chat and Quick AI conversations live in a combined history or stay **Separate**.
- **Auto-Archive Chats** — automatically archive chats after a period of inactivity. Default is **Never**.
##### API Keys
Bring your own API keys (OpenAI, Anthropic, etc.) to use AI at your own cost. When a key is set, Raycast routes requests through your provider and you pay their standard rates directly.
##### Commands
The AI extension ships with a full set of built-in commands you can alias, hotkey, or disable individually
#### Applications
The Applications settings let you fine-tune how Raycast finds, launches, and manages your installed apps. Toggle the switch in the top right to enable or disable Applications globally.
##### Auto Quit
Open Auto Quit to have Raycast automatically close apps shortly after you stop using them, freeing up memory without you having to think about it.
##### Hotkey Action
Choose what happens when you press an application's hotkey. The default, **Toggle Visibility**, brings the app to the front if it's hidden and hides it again on the next press.
##### Search Scopes
Use the **+** button to add extra folders so apps stored outside the standard locations show up in Raycast too.
##### Per-App Configuration
Use the search field to find any installed app, then configure it inline:
- **Add Alias** — give an app a custom name to type (for example, "music" for Spotify).
- **Record Hotkey** — assign a global keyboard shortcut to launch or toggle the app.
- **Checkbox** — disable individual apps you don't want to appear in Raycast's results.
##### Commands
The Applications extension also ships with built-in commands you can alias, hotkey, or disable like any other:
- **Uninstall Applications** — quickly remove installed apps directly from Raycast
#### Extensions
Below the list of Applications, each installed extension appears as its own entry in the sidebar. Select any extension to manage its preferences, authenticate with third-party services, enter access tokens, and assign shortcuts to its commands.
##### Browsing Extensions
Extensions are grouped into categories in the left sidebar: Built-in commands, Store extensions, Script Commands, and Quicklinks. Select any extension to see its commands and settings.
##### Enabling & Disabling Commands
Each command has a toggle to enable or disable it. Disabled commands won't appear in Root Search. This is useful for hiding commands you don't use to keep your search results clean.
##### Extension-Specific Settings
Many extensions expose their own configuration options. For example, a Jira extension might ask you to log in, or a GitHub extension might let you choose a default repository. These settings appear when you select the extension in the sidebar.
##### Uninstalling Extensions
To remove a Store extension, select it in the sidebar and click the Uninstall button, or right-click the extension and choose Uninstall.
### What's New in Raycast for Mac v2
Source: https://manual.raycast.com/new-in-v2
Description: Tour what's new in Raycast for Mac v2, including a redesigned UI, improved hotkeys, AI Agents, Memory, branching chats, Personalization, and more.
Last updated: 04 June 2026
Here's a tour of the big and small improvements you'll find across the app. Many of these were among the most-requested features from our community, so we listened and built them for you.
#### General
- A fresh new look and feel across the app, redesigned for macOS Tahoe.
- A simpler, cleaner compact mode that's easier to scan at a glance.
- Application symlinks now show up in Root Search, so you can launch them just like any other app.
- **Raycast in Raycast**: more reliable pasting between Raycast apps, such as sending a Quick AI response into Raycast Notes.
- Search in the Raycast Settings sidebar, allowing you to quickly find any extension, command, or preference across Raycast Settings.
#### [Shortcuts](https://manual.raycast.com/settings#shortcuts)
- A new and improved hotkey recorder that's quicker and more reliable to set up.
- Use the `fn` key on its own as a single-tap modifier, perfect for a quick shortcut without holding multiple keys.
- Support for single-tap `fn` key and double tap modifiers.
- Improved support for international keyboards. You can now record your hotkeys as either physical or key-equivalent keys.
- Better detection when shortcuts overlap, with a clear option to overwrite the existing one.
- Assign hotkeys and aliases right from the Action Panel in Root Search, no need to dig into **Raycast Settings**.
- You can now assign left and right modifier keys as hotkeys. Simply click on the key when you set it up in the Action Panel in Root Search or directly in **Raycast Settings > Shortcuts**
- Hyper Key is more reliable, with new diagnostics for conflicts with other apps, Karabiner remappings, and system keyboard remappings.
#### [File Search](https://manual.raycast.com/file-search)
- Now powered by a new indexing engine for faster results and more ways to filter.
- Files and folders can now be found right in Root Search, so you don't need a separate command to look them up.
#### [Snippets](https://manual.raycast.com/snippets)
- Added support for tagging, so you can organize and find snippets faster.
- Major reliability improvements for snippet expansion across Chromium and Electron apps, plus better handling of multiline snippets. Shorter snippets also expand faster.
#### [Quicklinks](https://manual.raycast.com/quicklinks)
- Added support for pinning, so your most-used Quicklinks always stay at the top.
- Added support for tagging to keep large collections of Quicklinks organized.
- Added **Prefer Existing Tabs**, which focuses an already-open tab when launching a Quicklink instead of opening a new one.
- **Create Quicklink** now autofills the path of the selected file when Finder is active.
#### [Clipboard History](https://manual.raycast.com/clipboard-history)
- Clipboard capture is now more reliable: Raycast detects changes directly instead of polling every 0.75 seconds, so fast consecutive copies are no longer missed.
- More reliable detection of the source app for each clipboard entry.
- Raycast now saves every original format you copied and lets you restore them, so pasting always matches the source.
- Rename clipboard entries to make them easier to find later.
- When you copy multiple files or pieces of content at once, they're now grouped together as a single clipboard entry.
- Refreshed UI for browsing history, with several visual improvements over v1.
- When pasting, you can now prefer plain text over the original formatting — enable "Prefer pasting as plain text" in settings to strip rich formatting automatically.
- Copy text directly from QR codes found in images stored in your clipboard history.
#### [Translator](https://manual.raycast.com/translate)
- Set default source and target languages so you don't have to pick them every time.
- Create custom commands with predefined language pairs, so you can jump straight into translating your most-used languages without picking them each time.
- New **Use Selected Text as Source** setting. When it's on, triggering the translator via hotkey automatically fills in whatever you have selected.
- Inline translation with the `in` suffix, so you can translate right as you type.
#### [Emoji & Symbols](https://manual.raycast.com/emoji-symbols)
- Multiple grid size options, so you can pick the layout that suits you best.
#### [Screenshots](https://manual.raycast.com/screenshots)
- **Column Count**: choose between 3, 4, 5, or 6 columns in the Search Screenshots grid to tune thumbnail size and density to your liking.
#### [Calendar](https://manual.raycast.com/calendar)
- New **Create Event** command for adding events without leaving Raycast.
#### [Calculator](https://manual.raycast.com/calculator)
- Added syntax highlighting so expressions are easier to read at a glance.
- Several new syntax to use in Calculator, including:
- **Work hours and days**: `workhours in 2023`, `55h in workdays`.
- **Pixel calculations**: `2 inches in px at 72 ppi`.
- **Trigonometry**: `cot`, `csc`, plus hyperbolic, inverse, and degree variants (`coth`, `csch`, `acot`, `acsc`, `cotd`, `cscd`, `acotd`, `acscd`).
- **Time diff shorthand**: `time diff Paris`, `diff Paris`.
- **Date/time expressions**: `time in 4 hours [in San Francisco]`, `3 days from now at 4:39pm`, ISO 8601 Zulu.
- **Calendar arithmetic**: `August 5 + 5` (days), `3:45pm + 5` (hours), `8am to 4pm`.
- **Percentage phrases**: `20% discount off $500`, `5% gratuity on $95`.
- **Percentage ratios**: `20% of 500, 90-30%`.
- **Percentage elapsed**: `day percentage`, `week %`, `year percentage`.
- **US customary units**: `5 feet 3 inches in cm`; more `ft`/`in` aliases.
- **Unit shorthands**: `mo`, `yr`, `deg`.
- **Currency shorthand**: `USD1K`; `10K` = 10,000 (`10 K` = kelvin); `kilo` as a synonym for `kg`; no-space `1kUSD`.
- **Cities and airports**: 119 new tourist destinations and airports; multi-word resolution (`London Heathrow`); aliases for multi-airport cities.
- Other fixes and improvements to existing syntax and expressions.
#### [Window Management](https://manual.raycast.com/window-management)
- New **Switch to Next Space** and **Switch to Previous Space** commands to jump between Spaces without the macOS animation.
#### [Dynamic Placeholders](https://manual.raycast.com/dynamic-placeholders)
- New `{calculator}` placeholder for inline math, available in **Snippets**, **Quicklinks**, and **AI Commands**.
#### AI
##### [Quick AI](https://manual.raycast.com/ai/chat#quick-ai)
- Redesigned to match AI Chat, with a more powerful composer for richer prompts.
- Tool calls and AI Commands now show richer detail — expand any run to inspect the inputs the model passed.
- Added Quick AI as a fallback command (**Raycast Settings → Launcher → Fallback Commands**)
##### [AI Chat](https://manual.raycast.com/ai/chat#ai-chat)
- Presets are now called **Agents**, and they're reused across chats. Update an agent's configuration once and the change applies to every chat that uses it. Learn more on the [Agents page](https://manual.raycast.com/ai/agents).
- Added **Memory** so chats remember context about you and feel more personal. Learn more on the [Personalization page](https://manual.raycast.com/ai/personalization).
- Added **Skills** so you can give Raycast AI custom instructions and knowledge for the tasks you do often. Learn more on the [Skills page](https://manual.raycast.com/ai/skills).
- Skills and AI Extensions are now loaded into the chat dynamically when they're relevant, so you don't need to mention them manually.
- Tool calls and AI Commands now show richer detail — expand any run to inspect the inputs the model passed.
- Chats can be auto-archived after a set period, keeping your sidebar tidy without any manual cleanup.
- Branch off any message in a chat to explore a different direction without losing the original thread.
##### [Dictation](https://manual.raycast.com/ai/dictation)
- Dictation turns speech into clean, formatted text and pastes it directly into the app you're in, with filler words and punctuation handled for you.
- **Auto Styling** picks the right tone for where you're typing, so dictation in Mail comes out as an email and dictation in Slack comes out as a quick message.
- **Custom Vocabulary**, **Instructions**, and **Styles** let you teach Dictation your spellings, your tone, and your own per-app templates.
- Press or hold to talk. Tap the hotkey to start and stop, or hold it down for push-to-talk, with the Dictation Pill keeping you in flow.
- **Dictation History** gives you back every past transcription, ready to paste, copy, or delete.
##### [Personalization](https://manual.raycast.com/ai/personalization)
- Added **Profile**, where you can jot down context about yourself (role, preferred tools, communication style) that Raycast AI uses across conversations.
- Added **Memory**, an automatic summary Raycast AI builds from your conversations over time, picking up on your projects, preferences, and goals.
- Both are fully editable, and you can turn them off any time in **Raycast Settings → AI → Personalization**.
Plenty more improvements are scattered throughout Raycast v2 — many of them your most-requested. Thanks for sharing your ideas on making Raycast better and use the **Send Feedback** command to share your thoughts on the new Raycast.
[Download Raycast v2](https://raycast.com/new)
- [Announcement](https://raycast.com/blog/the-new-raycast): Read about what's new in v2 in the launch post
- [The Technical Story](https://raycast.com/blog/a-technical-deep-dive-into-the-new-raycast): Read the post about how we built the new Raycast
#### Coming Soon
There are still some features that are not yet available in the beta. We are still working on these so they will come soon.
- Cloud Sync
- Raycast Focus
- Inline Emoji Picker
- Bigger font size
- Calculator color picker
- Calculator flight tracker
- Local Models
- Custom Providers
#### FAQ
##### How is v2 different from v1?
Raycast v2 is a not a new update but a separate app that runs alongside Raycast v1. Because this is still a beta version of the app bugs and issues are expected. So this way you get to try the new experience without being forced into it. You can also run both apps in parallel to fill the gaps for any missing features.
##### What are the minimum requirements?
- Raycast v2 is built for macOS Tahoe and Apple silicon Macs. If you are still on Sequoia or earlier, you need to upgrade macOS before installing v2.
- To ensure a seamless onboarding experience, please install the latest version of Raycast v1, or at least `v1.104.16`.
##### How do I give feedback during the beta?
Your feedback is critical for us in this phase of development. Please use the **Send Feedback** command in Raycast.
If possible please also share your logs with us to help debug issues. You can copy your latest ones with us using the **Copy Raycast Logs** or **Reveal Raycast Logs** will open your log folder.
##### How do I import my data to v2?
During onboarding, you'll be prompted to import or migrate your data from Raycast v1.
If you skip this step or want to rerun it, you can do it manually using one of the following commands:
- **Migrate from Raycast v1** to automatically migrates your data from v1.
- Importing settings at this step will also import and migrate all of your shortcuts to Raycast v2 and disable them from working in Raycast v1. This to ensure that your hotkeys don't conflict.
- This is the recommended approach because there is some extra data that is not imported with the manual import. This includes Clipboard History, Wrapped and Emoji picker.
- **Import Settings and Data** to manually import from your `.rayconfig` file that you must export from Raycast v1.
##### How do I install custom extensions in the new version?
For custom extensions to import correctly, you need to be on the latest version of Raycast v1, or at least `v1.104.16`.
If these did not automatically import, you can do it manually by running `npx @raycast/api@latest dev` and the dev command should be clever enough to pick up the Beta version if it's running.
##### How do I re-enable my v1 hotkeys after migrating?
You can reverse the hotkey migration by setting your hotkey again in Raycast v1. This will need to be done per hotkey.
##### Are Enterprise features supported in the beta?
Raycast for Enterprise features are not yet available in Raycast v2. Please continue using Raycast v1 if these are necessary in your organization.
##### v1 and v2 open at the same time. How can I fix it?
This means you have the same hotkey set for Raycast v1 and v2, so they are both launching at the same time.
You can either change one of your hotkeys to a different one in **Settings -> General**, or — our recommended approach — replace v1's hotkey with v2's:
1. Run the **Quit Raycast** command to quit Raycast v1.
2. Press your hotkey again to open Raycast v2.
3. Open **Raycast Settings -> General -> Raycast Hotkey**.
4. Click **Replace Raycast v1**. Raycast v1's hotkey will be disabled and only Raycast v2 will launch from now on.
## Core Features
### Snippets
Source: https://manual.raycast.com/snippets
Description: Store and auto-expand text snippets from Raycast. Type a keyword in any app to instantly paste templates, code, addresses, signatures, and more.
Platforms: Mac, Windows, iOS
Last updated: 04 June 2026
Snippets let you store frequently used text and insert it anywhere on your computer with just a few keystrokes. Whether it's email templates, code blocks, addresses, or emoji sequences, Snippets save you from typing the same things over and over. In v2, Snippets gain support for tagging and a new `{calculator}` [dynamic placeholder](https://manual.raycast.com/dynamic-placeholders).
> [!TIP]
> Open Snippets by searching for "Search Snippets" or "Create Snippet" in Root Search, or assign a hotkey for instant access.
#### Creating a Snippet
To create a new Snippet:
1. Open Raycast and search for **Create Snippet**
2. Enter the text you want to save in the **Snippet Text** field. This can be plain text, formatted content, code, or any text you type repeatedly.
3. Give your Snippet a **Name** so you can find it later.
4. Optionally assign a **Keyword** to enable auto-expansion (see below).
5. Optionally add **Tags** to organize your Snippets into groups.
> [!NOTE]
> Snippet text has a maximum length of 65K characters. This limit exists for performance reasons — in practice, most Snippets are well within this range.
#### Keywords & Auto-Expansion
Keywords are the real power behind Snippets. When you assign a keyword to a Snippet, typing that keyword in any application automatically replaces it with the full Snippet text. This works everywhere: in your browser, code editor, email client, chat apps, and more.
##### How Auto-Expansion Works
1. Assign a keyword to your Snippet (e.g., `!email`, `;;addr`, `/sig`)
2. Type the keyword in any text field on your computer
3. Raycast automatically replaces the keyword with your Snippet text
> [!TIP]
> Choose keywords that are unlikely to be typed accidentally. Prefixes like `!`, `;;`, or `//` work well. For example, `!thanks` is safer than just `thanks`.
##### Auto-Expansion Settings
You can enable or disable auto-expansion globally in **Raycast Settings → Snippets**. When disabled, Snippets still work — you just need to search for them in Raycast and paste manually instead of using keyword triggers.
{/* TODO: add screenshot — apps/raycast/public/images/app/core-features/snippets/mac-snippets-autoexpansion-settings.png */}
##### Keyword Character Reference
Not all characters can be used in keywords. Raycast uses certain characters as word-boundary delimiters, which means they will trigger expansion rather than become part of the keyword itself.
**Characters that cannot be used in keywords:**
- **Backtick**: `` ` ``
- **Quotation marks**: single quote `'`, double quote `"`, and their curly/smart variants `' ' " "`
- **Whitespace**: spaces, tabs, and newlines
- **Other delimiters**: some additional punctuation characters act as word boundaries and will trigger expansion instead of being included in the keyword
**Characters that can be used in keywords:**
- **Letters**: all Unicode letters (Latin, Cyrillic, CJK, etc.)
- **Numbers**: `0–9`
- **Hyphen & underscore**: `-` and `_`
- **Math symbols**: such as `+ = < >`
- **Currency symbols**: `$ € £ ¥` and others
- **Most punctuation**: including `! ; / . , @ # ~ &` (except the restricted characters listed above)
> [!TIP]
> Keywords like `!email`, `;;addr`, `/sig`, and `$price` are all valid. Keywords like `my email` (contains a space) or `it's` (contains an apostrophe) are not, because the space and quote act as delimiters.
#### Searching & Managing Snippets
The **Search Snippets** command gives you a central view of all your Snippets. From here you can:
- Search by name, keyword, or content
- Filter by tag to quickly narrow down your collection
- Copy a Snippet to your clipboard
- Paste a Snippet directly into the active application
- Pin frequently used Snippets to the top of the list
- Edit, duplicate, or delete Snippets
#### Dynamic Placeholders
Snippets support [Dynamic Placeholders](https://manual.raycast.com/dynamic-placeholders) — arguments that are replaced with dynamic data when the snippet is expanded. This lets you create context-aware Snippets that adapt every time you use them.
#### Tags
**New** Snippets now support tagging. Tags let you organize your Snippets into logical groups — for example, by project, language, client, or purpose. You can assign one or more tags when creating or editing a Snippet, and then filter by tag in the Search Snippets view to quickly find what you need.
To add a tag:
1. Open the Snippet editor (create a new Snippet or edit an existing one)
2. Use the **Tags** field to assign one or more tags
3. Type a new tag name to create it, or select from existing tags
In the Search Snippets view, use the tag filter dropdown to show only Snippets with a specific tag. This makes it easy to manage large Snippet collections.
#### Shared Snippets (Teams)
With Raycast for Teams, you can create shared Snippets that are available to everyone on your team. This is ideal for maintaining consistent messaging: support responses, company boilerplate, onboarding templates, and more.
Shared Snippets are managed from the same Search Snippets interface. They appear alongside your personal Snippets and can be filtered separately. Team admins can manage shared Snippets from the Raycast Teams dashboard.
#### Importing Snippets
Raycast supports importing Snippets from other text expansion tools and from CSV files. To import:
1. Open Raycast and search for **Import Snippets**
2. Select your source file (CSV or a supported export format)
3. Review the imported Snippets and confirm
This makes it easy to migrate from tools like TextExpander, aText, Espanso, or PhraseExpress without losing your existing library.
#### Use Cases & Examples
Here are some practical ways to use Snippets:
- **Email signatures**: Keyword `!sig` expands to your full signature with name, title, and contact info
- **Meeting notes template**: Keyword `!notes` expands to a structured template with `{date}` and `{cursor}` placeholders
- **Code snippets**: Keyword `;;log` expands to `console.log({cursor})`
- **Support replies**: Tag your customer support responses and quickly filter by client or issue type
- **Emoji combos**: Keyword `!shrug` expands to `¯\_(ツ)_/¯`
#### Settings
Open Raycast Settings (`⌘` `,`) and select **Snippets** from the sidebar to configure how Snippets expand. Use the toggle in the top-right corner to enable or disable the Snippets feature entirely.
##### Snippet Expansion
- **Enable Snippet Expansion**: Master toggle for automatic keyword expansion. Turn it off if you want to keep your Snippets library but stop them from auto-expanding as you type.
- **Expansion Mode**: Choose when a Snippet expands after you type its keyword:
- **Immediately**: Inserts the text as soon as the keyword is matched.
- **After Delimiter (keeping)**: Waits until you type a delimiter (e.g. space, punctuation), then expands and keeps the delimiter.
- **After Delimiter (discarding)**: Waits for a delimiter, then expands and discards the delimiter from the output.
- **Expand within Words**: When toggled off, a Snippet only expands when its keyword is typed as a standalone word. Turn it on if you want keywords to also expand when they appear inside a larger word.
- **Override System Snippets**: When enabled (experimental), Raycast expands its Snippets before macOS's built-in System Snippets. When disabled, Raycast skips expansion for keywords that conflict with system ones to avoid double insertion.
- **Injection Delay**: Adds a delay before Raycast types the expanded text. This lets you type words that happen to contain a Snippet keyword without triggering expansion, and gives slower apps time to receive the input correctly. Options range from None and Short through Regular, Long, and Extra Long. Increase the delay if expansion is unreliable in specific apps.
- **Response Time**: Controls how quickly Raycast processes clipboard entries during expansion. Options range from Instant and Quick through Default, Delayed, and Extended. Try a slower setting if you notice missing characters or partial expansion in specific applications.
- **Completion Sound**: Optionally play a sound whenever a Snippet is expanded automatically. Useful as a confirmation cue, especially when using longer Snippets or dynamic placeholders like `{clipboard}` and `{date}`.
- **Disabled Applications**: Add applications where Snippet expansion should never run. 1Password and Keychain Access are included to prevent accidental expansion inside password fields. Click the **+** button to add more.
##### Commands
Assign aliases and hotkeys to the Snippet commands you use most:
- **Create Snippet**: Open the Snippet editor
- **Export Snippets**: Save your Snippets to a file for backup or sharing
- **Import Snippets**: Import Snippets from CSV, TextExpander, aText, Espanso, or PhraseExpress
- **Search Snippets**: Find and insert a Snippet from the list
Set the **Primary Action** for Search Snippets (e.g. **Paste to Active App** or **Copy to Clipboard**) to match how you most often use your library.
#### Troubleshooting
If Snippets aren't working as expected, here are some common issues and steps to resolve them.
##### My snippets from Raycast v1 aren't working after upgrading to v2
If snippets you created in v1 don't expand in v2, they likely weren't migrated. Run the `Migrate from Raycast v1` command in v2 (on a Mac with v1 installed, the first launch of v2 also prompts an automatic transfer). Make sure you're on Raycast for Mac v1.104.16 or newer before migrating.
Migration is additive, so it won't wipe your existing v2 setup.
If you're running both versions, only one should handle expansion. Open Raycast v1 → Raycast Settings → Extensions → Snippets and turn off **Enable Snippet Expansion** there, so v2 can expand snippets without the two conflicting. If snippets stopped working in v1 too, fully quit v2 and confirm only one version of Raycast is running.
##### Snippets aren't expanding when I type the keyword
- Make sure snippet expansion in v1 is disabled. If you're running both versions, only one should handle expansion. Open Raycast v1 → Raycast Settings → Extensions → Snippets and turn off **Enable Snippet Expansion** there, so v2 can expand snippets without the two conflicting. If snippets stopped working in v1 too, fully quit v2 and confirm only one version of Raycast is running.
- Make sure auto-expansion is enabled in **Raycast Settings → Snippets** (look for **Enable Snippet Expansion**).
- Check the **Expansion Mode**. If expansion is unreliable, try switching between **Immediately** and **After Delimiter**.
- If expansion is intermittent, increase the **Injection Delay**, and if text comes through partially, try a slower **Response Time**.
- _(Only on Mac)_ Check that Raycast has Accessibility permissions enabled in **System Settings → Privacy & Security → Accessibility**.
- Verify your keyword doesn't contain invalid characters (see the Keyword Character Reference above). Characters like quotes, backticks, and spaces will prevent the keyword from working.
- Some apps with custom text input fields (e.g., certain code editors, terminal emulators, virtual machines, or Apple Mail) may not support auto-expansion. Try pasting the Snippet manually from the Search Snippets command instead.
##### Line breaks or rich text aren't preserved when a snippet expands
Snippets with hard returns or formatting can paste on a single line or lose styling, depending on the target app. Confirm the line breaks are saved in the snippet itself (edit it in Search Snippets), then try a different paste method or a slower Response Time in **Raycast Settings → Snippets**. Some apps strip formatting on paste regardless, so note which app you're pasting into when reporting.
##### Snippet text is pasted incorrectly or partially
- If the expanded text appears garbled or incomplete, the target app may be interfering with the paste operation. Try increasing the paste delay or switching to a different paste method in Snippet settings.
- Ensure your Snippet text is within the 65,536 character limit.
##### Snippet keyboard shortcuts (like Cmd+1 to Cmd+8) aren't working
If the quick keyboard shortcuts for inserting snippets don't fire, confirm you're on the latest Raycast version, and check that no other app is bound to the same shortcut. Note which app you're in when it fails, since these shortcuts depend on the frontmost app passing the key combination through.
##### Dynamic placeholders aren't being replaced
Double-check the placeholder syntax. Placeholders must use curly braces, e.g., `{date}`, `{clipboard}`. A typo in the placeholder name will cause it to be inserted as plain text. For formatted dates, include the format inside the braces, e.g., `{date: YYYY-MM-DD}`.
##### Still having issues?
If none of the steps above resolve your issue, please reach out to our support team. To help us diagnose the problem quickly, include the following:
1. **A screen recording** showing the issue in action. For Mac and Windows, the quickest way is [ray.so/v2-record](https://ray.so/v2-record). Open the link in your browser, click record, capture what's happening, and share the resulting link. No install needed.
2. **The name and keyword** of the Snippet that isn't working.
3. **The app** where you're trying to use the Snippet (e.g., Chrome, VS Code, Slack, Notion).
4. **Whether you migrated from v1**, and whether v1 is fully quit.
5. **Your OS version** and **Raycast version** (found in **Raycast Settings → About**).
6. **Your Raycast logs**: Use the built-in **Copy Raycast Logs** command to copy your latest log files to the clipboard, or **Reveal Raycast Logs** to open your log folder.
### Quicklinks
Source: https://manual.raycast.com/quicklinks
Description: Turn any URL into a keyboard shortcut with Raycast Quicklinks — open sites, trigger searches, and jump to deep links across all your devices.
Platforms: Mac, Windows, iOS
Last updated: 04 June 2026
Quicklinks let you save frequently used URLs, file paths, and deeplinks so you can open them instantly from Root Search. Whether it's a web search, a project folder in your IDE, a Spotify playlist, or a Notion page, Quicklinks turn multi-step navigation into a single action. In v2, Quicklinks gain support for tagging, pinning, and the new `{calculator}` [dynamic placeholder](https://manual.raycast.com/dynamic-placeholders).
> [!TIP]
> Open Quicklinks by searching for "Search Quicklinks" or "Create Quicklink" in Root Search. Your Quicklinks also appear directly in Root Search results alongside commands and applications.
#### Creating a Quicklink
To create a new Quicklink:
1. Open Raycast and search for **Create Quicklink**
2. Enter the **Link**: a URL, file path, or deeplink
3. Give it a recognizable **Name** and optionally choose an **Icon**
4. On macOS, optionally choose an **Application** to open the link with (e.g., open a folder in VS Code instead of Finder)
5. **New** Optionally add **Tags** to organize your Quicklinks into groups
##### What can a Quicklink open?
Quicklinks support a wide range of link types:
- **Web URLs**: `https://github.com`, `https://figma.com/file/...`
- **File & folder paths**: `~/Projects/my-app` (macOS) or `C:\Projects\my-app` (Windows)
- **Deeplinks**: `spotify://playlist/...`, `slack://channel/...`
- **Search queries**: use dynamic arguments to build parameterized search URLs (see below)
##### Auto Fill
_(Only on Mac)_
When creating a Quicklink on macOS, the link field can be automatically populated from your active browser tab or clipboard. This requires Automation permissions and works with Safari, Chrome, and other major browsers.
#### Dynamic Placeholders
Quicklinks support [Dynamic Placeholders](https://manual.raycast.com/dynamic-placeholders) — arguments that are replaced with dynamic data when the Quicklink is used. This lets you create context-aware Quicklinks that adapt every time you use them.
#### Searching & Managing Quicklinks
The **Search Quicklinks** command gives you a central view of all your Quicklinks. From here you can:
- Search by name to find a specific Quicklink
- **New** Filter by tag to narrow down your collection (`⌘`/`Ctrl` `P`)
- Open the Action Panel (`⌘`/`Ctrl` `K`) to access additional actions
##### Available Actions
With a Quicklink selected, open the Action Panel to access:
- **Edit**: modify the link, name, icon, or tags
- **Duplicate**: create a copy to use as a starting point
- **Copy Name** / **Copy Link**: copy the Quicklink's name or URL to your clipboard
- **Create New**: start creating a new Quicklink
- **Delete**: remove the Quicklink
#### Tags
**New** Quicklinks now support tagging. Tags let you organize your Quicklinks into logical groups: for example, by project, client, or purpose. Assign one or more tags when creating or editing a Quicklink, then filter by tag in the Search Quicklinks view. This was a popular community request.
#### Pinning
**New** Quicklinks can now be pinned. Pinned Quicklinks appear at the top of Root Search results, giving you instant access to your most-used links without typing anything. Pin a Quicklink from the Action Panel or from Settings.
#### Shared Quicklinks (Teams)
With Raycast for Teams, you can create shared Quicklinks that are available to everyone on your team. This is ideal for frequently accessed resources: internal dashboards, documentation, staging environments, design files, and more. Shared Quicklinks appear alongside your personal Quicklinks and can be managed from the Raycast Teams dashboard.
##### More about shared Quicklinks
You can share Quicklinks with members of your organization. It's an easy way to access information and is ideal for links to your company's roadmap, dashboards, or other resources.
> [!NOTE]
> You must enable organizations in Raycast and have created your first organization before you can create a shared Quicklink.
**Create Shared Quicklink**
1. Search for the **Create Quicklink** command in Raycast.
2. In the form, select your Organization.
3. Enter a name and URL for the Quicklink.
4. Press `⌘`/`Ctrl` `↵` to create and publish the Quicklink.
Your Quicklink will now be available in Raycast for all of your organization's members. Shared Quicklinks display the organization's icon on the right-hand side of the item.
Shared Quicklinks are synced automatically between all organization members. Any changes made by one member will be propagated to all others.
**Managing Shared Quicklinks**
To manage shared Quicklinks, use the **Manage Quicklinks** command. By default you will see a list of your personal Quicklinks — these are stored locally in Raycast and not synced. To view your organization's shared Quicklinks, choose your organization from the filter menu at the top-right of the window.
You can perform various actions on the selected Quicklink using the Action Panel (`⌘`/`Ctrl` `K`), including **Edit**, **Duplicate**, **Move** (to another organization), or **Delete**. You'll be prompted to confirm before a destructive action such as move or delete. You can also create a new Quicklink using the **Create Quicklink** action.
**Settings**
You can also view and manage your shared Quicklinks in **Raycast Settings → Quicklinks**. Your organization's Quicklinks will appear in a separate group. You can perform actions on the selected Quicklink via the right-click context menu. Select the organization's group to create a new Quicklink from scratch or from Raycast's built-in library of pre-defined Quicklinks.
#### Importing Quicklinks
Raycast supports importing Quicklinks from JSON files. This is useful for sharing Quicklink collections with teammates or migrating from another setup. To import, search for **Import Quicklinks** in Root Search and select your JSON file.
##### More about importing Quicklinks
**JSON Format**
The JSON file must be an array of Quicklink objects. Each object supports the following fields:
- `name` — Quicklink title. Type: `String` (required)
- `link` — Quicklink URL. Type: `String` (required)
- `iconName` — Quicklink icon. Type: `String` (optional)
- `openWith` — Target app to open the Quicklink. Type: `String` (optional)
If no app is specified with `openWith`, the link will open in the default web browser. Deeplinks will be routed by the browser.
If no icon is specified with `iconName`, the default Quicklink icon will be used.
```json
[
{
"link": "https://duckduckgo.com/?q={argument}",
"name": "Search DuckDuckGo"
},
{
"openWith": "Finder",
"iconName": "folder-16",
"link": "~/Downloads",
"name": "Downloads"
},
{
"openWith": "Music",
"link": "https://music.apple.com/gb/station/apple-music-1/ra.978194965",
"name": "Apple 1"
},
{
"link": "shortcuts://run-shortcut?Name={Test}",
"name": "Run Shortcut"
}
]
```
After the import completes, you will see how many Quicklinks were added and how many duplicates were skipped. If a Quicklink has the same title and content, it is considered a duplicate.
#### Settings
Quicklink settings are available in **Raycast Settings → Quicklinks**. Here you can:
- Toggle link previews on or off
- Assign hotkeys and aliases to individual Quicklinks or to the Search/Create commands
- **New** Edit your Prefer Existing Tabs. When you open a Quicklink that points to a URL, Raycast first checks if that URL is already open in one of your browser tabs. If it is, Raycast switches to that tab instead of opening a new one. Keeping your tab count down and avoiding duplicates.
#### Use Cases & Examples
Here are some practical ways to use Quicklinks:
- **Search engines**: `https://google.com/search?q={argument name="query"}`, search Google from Raycast
- **GitHub repo**: `https://github.com/{argument name="org"}/{argument name="repo"}`, jump to any repo
- **Project folder**: `~/Projects/my-app` opened in VS Code, one keypress to start coding
- **Internal tools**: dashboard URLs, staging environments, admin panels
- **Translation**: a Google Translate Quicklink with arguments for source language, target language, and word
- **Daily standup**: a Quicklink to your team's standup Zoom/Meet link, pinned for one-click access
#### Settings
Open Raycast Settings (`⌘` `,`) and select **Quicklinks** from the sidebar to configure how Quicklinks behave and manage your library. Use the toggle in the top-right corner to enable or disable the Quicklinks feature entirely.
- **Show Link Previews**: Display a preview of the destination URL when browsing your Quicklinks in Root Search. Turn it off if you prefer a cleaner list without preview thumbnails.
- **Prefer Existing Tabs**: When opening a Quicklink, Raycast checks if the URL is already open in your browser and activates that tab instead of opening a new one. Helpful for avoiding duplicate tabs when you frequently revisit the same links.
##### Commands
Assign aliases and hotkeys to the Quicklinks commands you use most:
- **Create Quicklink**: Opens the Quicklink editor so you can save a new link directly from Settings. Toggle **Autofill selected text** to pre-fill the URL field with whatever text is currently selected in another app.
- **Export Quicklinks**: Save your Quicklinks to a file for backup or sharing.
- **Import Quicklinks**: Import Quicklinks from a previously exported file.
- **Search Quicklinks**: Find and open a Quicklink from your library.
##### Quicklinks
Below Commands, you'll find your full Quicklinks library. This is where both Personal Quicklinks (the ones you've created locally) and Team Quicklinks (shared via Raycast for Teams) are listed together. From here you can:
- Click **Create Quicklink** to add a new entry without leaving Settings.
- Assign an alias or hotkey to any Quicklink for faster access.
- Use the **...** menu next to a Quicklink to edit, duplicate, or delete it.
> [!TIP]
> Use the search field at the top of the Quicklinks list to quickly filter by name. For example, typing `file` surfaces your Finder File Quicklink along with anything else matching the term. This is the fastest way to manage a large library without scrolling.
#### Troubleshooting
##### Quicklink doesn't open or opens the wrong app
- Verify the URL or path is correct and accessible.
- On macOS, check that the correct application is selected in the "Open With" field.
- For deeplinks (e.g., `spotify://`), make sure the target app is installed.
##### Arguments aren't being substituted
- Check the placeholder syntax. Arguments must use curly braces: `{argument name="..."}`.
- You can use a maximum of 3 arguments per Quicklink.
##### Still having issues?
If none of the above resolves your issue, please reach out to our support team. Include the following:
1. **A screen recording** showing the issue. On macOS, press `⌘`/`Ctrl` `⇧` `5` to open the screen recording tool. On Windows, press `Win` + `Alt` + `R` to start recording with the Xbox Game Bar, or use the Snipping Tool.
2. **The Quicklink URL or path** (with any placeholders).
3. **Your OS version** and **Raycast version** (found in **Raycast Settings → About**).
4. **Your Raycast logs**: Use the built-in **Copy Raycast Logs** command to copy your latest log files to the clipboard, or **Reveal Raycast Logs** to open your log folder. Search for either command in Raycast.
### Clipboard History
Source: https://manual.raycast.com/clipboard-history
Description: Raycast's Clipboard History keeps every text, image, file, link, email, and colour you've copied so you can search, paste, and reuse anything in seconds.
Platforms: Mac, Windows
Tier: More with Pro
Last updated: 04 June 2026
Ever had the situation that you wanted to find something that you copied earlier? Raycast has a built-in Clipboard History for that. The command keeps track of all copied text, images, files, links, emails, and even colors.
To access it, find the **Clipboard History** command in Root Search. We recommend setting a custom Alias or Hotkey through the Shortcuts or Clipboard History tab in **Raycast Settings** (`⌘`/`Ctrl` `,`) in order to have direct access at all times.
**New**
- Raycast now saves every original format you copied. Use **Paste as…** to switch between rich text, plain text, RTF, HTML, and any other format the source provided, so what you paste always matches what you copied.
- When you copy multiple files or pieces of content at once, they're now grouped together as a single clipboard entry instead of being split apart.
- Rename clipboard entries to make them easier to find later.
- Enable **Prefer pasting as plain text** in settings to automatically strip rich formatting on every paste.
- Use **Copy Text from QR Code** to extract the encoded text or link from a QR code in an image in your history.
#### Actions
Within the Clipboard History command, you can search through your entries by name, or hit `⌘`/`Ctrl` `P` to filter them by type: Text, Images, Files, Links, Emails, or Colors.
With a clipboard entry highlighted, you can either hit `↵` to paste it into your active input field, or hit `⌘`/`Ctrl` `K` to access additional options in the Action Panel, such as:
- **Paste as Plain Text**: strip formatting before pasting
- **Copy to Clipboard** (`⌘`/`Ctrl` `↵`)
- **Copy Text from Image**: extract text from a screenshot or photo via on-device text recognition
- **Copy Text from QR Code**: extract the encoded text or link from a QR code in an image
- **Send to AI Chat**: open a new AI Chat with the entry as context (or Attach to AI Chat for files and images)
- **Edit Content**: make quick edits to text, links, or colors before pasting
- **Save as Snippet**: turn a frequently used entry into a Raycast Snippet
- **Rename Entry** (`⌘`/`Ctrl` `E`)
- **Pin Entry** (`⌘`/`Ctrl` `.`)
- **Delete Entry** (`⌘`/`Ctrl` `X`)
- **Delete Entries…**: bulk-delete by time window (last 5, 15, or 30 minutes, or last 1 or 24 hours) (`⌘`/`Ctrl``⇧``X`)
- **Delete All Entries** (`⌘`/`Ctrl` `⇧` `X`)
#### Settings
Open Raycast Settings (`⌘` `,`) and select **Clipboard History** from the sidebar to configure how Raycast records, retains, and pastes your clipboard items. Use the toggle in the top-right corner to enable or disable Clipboard History entirely.
##### History
**Keep history for**: Choose how long Raycast retains each clipboard item before it's deleted. Options include:
- 1 Day
- 1 Week
- 1 Month
- 3 Months
- 6 Months (Pro)
- 1 Year (Pro)
- Unlimited (Pro)
> [!TIP]
> On Raycast Pro? Longer retention isn't enabled automatically. Open **Raycast Settings → Clipboard History → Keep history for** and pick **Unlimited** (or 6 Months / 1 Year) to use it.
##### Text Recognition
- **Text Recognition**: When enabled, Raycast automatically extracts text from images you copy so they can be searched alongside regular text entries. Helpful for quickly grabbing text from screenshots without an OCR step.
- **Recognition Mode**: Choose between faster processing or more accurate text extraction:
- **Fast**: Lower CPU usage, suitable for most everyday screenshots.
- **Accurate**: Better recognition for small text, mixed fonts, or low-contrast images, at the cost of higher CPU usage.
##### Disabled Applications
Add applications where clipboard changes should not be recorded. Common examples like Passwords and Keychain Access are included to prevent sensitive values from ending up in your history. Click the **+** button to add more, for example password managers or banking apps.
##### Commands
Assign aliases and hotkeys to the Clipboard History commands you use most:
- **Clipboard History**: Open the searchable history list to paste a previous item. Expand the command to access these options:
- **Primary Action**: Choose what pressing Return does on a selected entry. **Paste to Active App** inserts the item into the focused app, while **Copy to Clipboard** puts it back at the top of your clipboard.
- **Prefer pasting as plain text**: When enabled, pasting prioritises plain text over restoring the original copied formats.
- **Show visual information for links**: When enabled, social card images and favicons are fetched and displayed for link entries, making them easier to identify at a glance.
- **Update history after action**: When enabled, clipboard items are moved to the top of the list after a copy or paste action, so your most recently used items stay easy to find.
- **Paste Sequentially**: Paste multiple clipboard items one after another in sequence. Expand the command to access these options:
- **Sequence Timeout**: How long Raycast waits between pastes before resetting the sequence. The default selection of 30 Seconds works well for filling out forms across fields.
- **Add a new line after pasting text**: When enabled, Raycast inserts a line break after each pasted item, useful for pasting lists or filling multi-line text areas.
##### AI Extensions
- **Ask Clipboard**: A built-in AI Extension that lets you query and act on your clipboard history through natural language (for example, "find the last URL I copied" or "summarize the article I copied earlier"). Assign an alias or hotkey to make it easier to invoke.
#### Troubleshooting
Clipboard History keeps a searchable record of what you copy. In the v2 Beta most reports come down to history not recording, images not being captured, paste formatting, or the hotkey not opening the window. Here are the common ones.
##### Clipboard History isn't recording anything (or stopped after updating)
If old entries are there but no new copies are saved, work through these checks:
- Make sure Raycast v1 is fully quit, not just disabled. Running v1 and the Beta at the same time can stop the Beta from recording. Quit v1 entirely, then reopen the Beta.
- Confirm Clipboard History is enabled in **Raycast Settings → Clipboard History**, then copy a plain piece of text and check whether it appears.
- Test whether it fails for copies from every app or only specific ones, and note which.
- Check your account and permissions. If Raycast is in `/Applications` and that folder is only writable by an admin, a standard user account can be blocked from saving. Confirm whether you're on an admin or standard account.
- On managed Macs, an MDM or security profile can block clipboard monitoring even if v1 worked. On a work device, check with your IT admin.
If it still won't record, send us your logs via the **Copy Raycast Logs** command.
##### Images or screenshots aren't saved, or paste without a file extension
Some image and screenshot entries may not appear in history, or paste without their file extension so the target app can't open them. Confirm the image actually copied (paste it directly into another app first). If it's in history but pastes broken, send us a screen recording, the app you copied from, and the app you're pasting into so we can reproduce.
##### Pasting keeps the formatting, or "Paste as Plain Text" doesn't always work
The default paste behavior changed from v1. To drop formatting on a single entry, use the "Paste as Plain Text" action from the entry's action panel. If that command still retains formatting in some apps, note which app you're pasting into, since some apps re-apply their own styling on paste, and send us a screen recording. If you want plain text every time, set your preferred default in **Raycast Settings → Clipboard History**.
##### The hotkey doesn't open Clipboard History
If your Clipboard History hotkey doesn't open the window, check for another app bound to the same shortcut and confirm the hotkey in **Raycast Settings → Clipboard History**. Some combinations are unreliable: double-modifier binds like Option + Option can fail to trigger while Caps Lock is on, so try a standard modifier combination if yours isn't firing.
##### Still having issues?
Send us:
- a screen recording
- whether Raycast v1 is fully quit
- the app you copied from and the app you're pasting into
- whether the content was an image, formatted text, or plain text
- whether it happens with every app or only specific ones
- whether you're on an admin or standard account, and whether the Mac is managed (MDM)
- your OS and Raycast version (**Settings → About**)
- your logs via the **Copy Raycast Logs** command
For the screen recording, the quickest way is [ray.so/v2-record](https://ray.so/v2-record). Open the link in your browser, click record, capture what's happening, and share the resulting link in your report. No install needed.
### File Search
Source: https://manual.raycast.com/file-search
Description: Find any file on your computer by name from Root Search or the dedicated Search Files command, with full control over what's indexed.
Platforms: Mac, Windows
Last updated: 28 May 2026
File Search turns Raycast into the fastest way to find a file on your computer. Type in Root Search and matches appear inline as you go or use the **Search Files** command for richer details and metadata without opening Finder or Explorer.
[File Search in Raycast (YouTube)](https://www.youtube.com/watch?v=nQl8Wrue3oQ)
#### Get Started
1. Start typing a file or folder name in Root Search. Matching results appear inline alongside your apps, commands, and history.
2. Press `↵` to open the selected result, or `⌘`/`Ctrl` `K` to open the Action Panel for more actions.
3. For a richer view, open the **Search Files** command. The command will show a wider results list, a details panel showing file metadata, and the same actions as Root Search. When the search field is empty, the command shows your **Recently Used** files.
> [!NOTE]
> File Search matches on **file name** alone and doesn't index file contents. Any searches for content within a file will not show matching results.
> [!TIP]
> Type any file path into Root Search and you'll see an `Open in Finder`/`Open in File Explorer` command to take you straight to that location.
#### What Gets Indexed
By default, Raycast indexes your home folder, and on Mac it also indexes `/Applications`. Hidden files are excluded, and Raycast respects `.gitignore`, `.ignore`, Git exclude files, and `.rayignore` files. Common noise like `node_modules`, `*.tmp` files, and system caches is filtered out automatically.
> [!NOTE]
> Your file index is stored locally on your device and is never synced or uploaded to Raycast servers.
##### Permissions
_(Only on Mac)_
On first launch, Raycast requests permission to scan your home folder. If you prefer, grant permission to individual folders instead and File Search will index just those. If you skip this during setup, you'll see a prompt when you open the **Search Files** command.
#### .rayignore
A `.rayignore` file works like `.gitignore`, but for Raycast's File Search. Place one in any folder to tell Raycast what to skip. List one path or glob pattern per line, and rules apply to that folder and all subfolders. This is useful when you want to exclude something from File Search without touching your Git config, such as a tracked build directory you don't want cluttering results.
The **Exclude from Index** action in **Search Files** handles this for you. Select a file, run the action, and Raycast walks up the directory tree to find the nearest `.rayignore`, appends the rule, or creates a new `.rayignore` in the file's parent folder if none exists.
#### Settings
All File Search settings can be found in **Raycast Settings → File Search**.
- **Search Scopes**: Add or remove additional folders to be included when searching for files. Useful for bringing in an external drive or a specific project folder not in your home folder.
- **Ignore Patterns**: Comma-separated glob patterns to skip globally (for example `*.log, build/**`). Combine with `.rayignore` files for per-folder rules.
- **Include Hidden Files**: Index dotfiles, folders that start with `.`, and other hidden files on your system.
- **Use Ignore Files**: Respect `.gitignore`, `.ignore`, and `.rayignore` files. On by default.
- **Keep Files from Removed Volumes**: Preserve indexed results for files on external or network drives even when those drives are disconnected or unavailable.
If you would like to turn off File Search in Root Search, you can do so from **Raycast Settings -> Launcher -> Include Files in Root Search**.
#### Actions
With a file selected in either Root Search or the **Search Files** view, press `⌘`/`Ctrl` `K` to open the Action Panel. Several File Search-specific actions you can use in Raycast:
- **Show Details in File Search**: Opens the **Search Files** command to the selected file with the details panel open.
- **Quick Look**: Preview the file without opening it.
- **Open in Terminal**: Opens the folder in your default terminal. Folders only.
- **Save as Quicklink**: Turn the file into a [Quicklink](https://manual.raycast.com/quicklinks) so you can launch it by name later.
- **Save as Duplicate**: Creates a copy of the file alongside the original.
- **Send to Quick AI** / **Send to AI Chat** _(Only on Mac)_: Attach the file to a new Chat as context. Files only.
- **Toggle Hidden Files**: Includes hidden files on your computer in File Search.
- **Index Files**: Force a fresh scan of your file index. You can also use the **Stop Indexing** action from the indexing toast to pause it.
#### Ask Finder
_(Only on Mac)_
You can use the `@finder` AI Extension in [Chat](https://manual.raycast.com/ai/chat) to chat with files on your computer using the same index as File Search. You can ask questions like "find the PDF I downloaded last week from Apple" or "open the most recent screenshot from this morning" to find what you're looking for without knowing the exact file name.
**Ask Finder** is also available as a [fallback command](https://manual.raycast.com/settings#fallback-commands). This means you can type your file search into Root Search with no matching results and use the **Use with Ask Finder** command at the bottom of results to locate it on your Mac.
### Notes
Source: https://manual.raycast.com/notes
Description: Capture and access quick notes directly in Raycast — synced across Mac, Windows, and iPhone so your thoughts are always within reach.
Platforms: Mac, Windows, iOS
Tier: More with Pro
Last updated: 04 June 2026
Raycast Notes makes it frictionless to organize your thoughts from anywhere on your Mac. You can track your todos, take notes during meetings, and save your next big idea. It's designed to be lightweight with Markdown support and is just a keystroke away with a deep integration into the rest of Raycast's ecosystem.
Our note-taking experience comes with three commands:
- **Raycast Notes:** This command simply toggles the Notes window.
- **Create Note:** This command creates a new note and opens the window. It's ideal to capture your thoughts with zero friction.
- **Search Notes:** This command allows you to search all your notes by title and content, making it easy to revisit previous notes.
> [!TIP]
> We recommend assigning a hotkey to the Raycast Notes command for quicker access. A commonly used hotkey is `⌥` `N` (`Alt` `N` on Windows).
>
> Type `Raycast Notes` into the main Raycast window, then choose Configure Command → Set Hotkey from the `⌘` `K` (`Ctrl` `K` on Windows) Action menu. Alternatively, set the hotkey from Settings → Raycast Notes.
#### Creating
It all starts by creating a new note. It can be your next big idea or just a way to jot down some thoughts. If you have Raycast Notes already open, you can click the plus button in the top-right corner of the toolbar (or press `⌘` `N` / `Ctrl` `N` on Windows) to create a new note.
Alternatively, you can use the Create Note command in [Raycast's root search](https://manual.raycast.com/search-bar), which is globally available. After you have successfully created a new note, you can start writing. The first line of the note is used as the title of the note, which is shown in the toolbar.
#### Editing
Raycast Notes offers a lightweight editing experience that allows you to format your note with ease.
There are four ways to format your notes:
1. By typing Markdown syntax like creating a heading with `#`
2. By pressing keyboard shortcuts like `⌘` `B` (`Ctrl` `B` on Windows) to make text bold
3. By performing the Format action via the Action Panel (`⌘` `K` / `Ctrl` `K` on Windows)
4. By activating the Format Bar on the bottom of the window
Below is an overview of all formatting options and their corresponding keyboard shortcut and Markdown syntax.
##### Paragraph Formatting
Everything you need to organize your content into clear, structured sections - from headers and lists to specialized blocks that help keep your notes tidy and easy to navigate.
| Format | macOS Shortcut | Windows Shortcut | Markdown Syntax |
| ------------ | -------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| Heading 1 | `⌥` `⌘` `1` | `Ctrl` `Alt` `1` | Type `#` at the beginning of a new line |
| Heading 2 | `⌥` `⌘` `2` | `Ctrl` `Alt` `2` | Type `##` at the beginning of a new line |
| Heading 3 | `⌥` `⌘` `3` | `Ctrl` `Alt` `3` | Type `###` at the beginning of a new line |
| Code block | `⌥` `⌘` `C` | `Ctrl` `Alt` `C` | Type ``` (three backticks and a space) or `~~~` (three tildes and a space) at the beginning of a new line |
| Blockquote | `⇧` `⌘` `B` | `Ctrl` `Shift` `B` | Type `>` at the beginning of a new line |
| Ordered list | `⇧` `⌘` `7` | `Ctrl` `Shift` `7` | Type `1.` (or any other number followed by a dot) at the beginning of a new line |
| Bullet list | `⇧` `⌘` `8` | `Ctrl` `Shift` `8` | Type `*` or `-` at the beginning of a new line |
| Task list | `⇧` `⌘` `9` | `Ctrl` `Shift` `9` | Type `[ ]` for an unchecked task or `[x]` for a checked task at the beginning of a new line |
To toggle a task’s checked state, place the cursor on the task line and press `⌘`/`Ctrl` `Enter`.
##### Text Formatting
Basic styling options that let you modify the appearance of individual words or phrases within your text to emphasize important points, add links, or create distinctions.
| Format | macOS Shortcut | Windows Shortcut | Markdown Syntax |
| --------------------------- | -------------- | ------------------ | -------------------------------------------------------------- |
| **Bold** | `⌘` `B` | `Ctrl` `B` | Type `**two asterisks**` or `__two underlines__` |
| _Italic_ | `⌘` `I` | `Ctrl` `I` | Type `*one asterisk*` or `_one underline_` |
| ~~Strikethrough~~ | `⇧` `⌘` `S` | `Ctrl` `Shift` `S` | Type `~~two tildes~~` |
| Underline | `⌘` `U` | `Ctrl` `U` | N/A |
| `Code` | `⌘` `E` | `Ctrl` `E` | Type `` `one backtick` `` |
| [Link](https://raycast.com) | `⌘` `L` | `Ctrl` `L` | Type `[link text in square brackets](https://manual.raycast.com/link-url-in-parentheses)` |
##### Other Formatting
Additional formatting elements that help you enhance your notes with visual separators and expressive elements like emojis to improve readability and communication.
| Format | macOS Shortcut | Windows Shortcut | Markdown Syntax |
| --------------- | -------------- | ---------------- | -------------------------------------------------------------------------------------------------- |
| Emoji | N/A | N/A | Type `:` to open the inline emoji picker |
| Horizontal rule | N/A | N/A | Type three dashes (`---`) or three underscores and a space (`___ `) at the beginning of a new line |
#### Organizing
Raycast Notes offers support for multiple notes but balances it with a lightweight user interface. Only one note is visible at the time. Notes are organized as a stack. You can think of them as a notepad with multiple pages. To access previous notes, you can click the Browse Notes tool bar item in the top right or press `⌘` `P` (`Ctrl` `P` on Windows).
Alternatively, you can use the Search Notes command in Raycast's root search. This is handy when you want to quickly open a note, such as a note for your 1:1 with your manager.
##### Pinning
Some notes are more important than others and you want to revisit them on a regular basis. Those notes can be pinned to the top of the Search Notes command and the Browse Notes action. To pin a note, press `⇧` `⌘` `P` (`Ctrl` `Shift` `P` on Windows) (from the Search Notes window, it's `⌘` `.` / `Ctrl` `.` on Windows).
Once a note is pinned, it can be accessed with `⌘` `0`…`9` (`Ctrl` `0`...`9` on Windows) while you have the Notes window open. This is similar to how pinned tabs work in most browsers and should feel familiar.
##### Navigating
Raycast Notes keeps your focus on a single note at a time. But sometimes you want to go back and forth between multiple notes. You can use the `⌘` `[`/`]` (`Ctrl` `[`/`]` on Windows) keyboard shortcuts to navigate between previously opened notes. This is similar to how the navigation hierarchy works in most browsers.
> [!TIP]
> You can adjust the zoom level of the Notes content by using `⌘`/`Ctrl` `-` / `+` to zoom out or in, or `⌘`/`Ctrl` `0` to return to actual size, or in **Raycast Settings -> Raycast Notes -> Zoom**.
#### FAQ
##### Are Raycast Notes synced across devices?
Yes, Raycast Notes supports Cloud Sync as part of an [active Pro
subscription](https://www.raycast.com/pro). That means you can start a note on one device and
continue it on another.
##### What is free and paid in Raycast Notes?
You can use Raycast Notes for free with up to 5 notes. If you want more notes, you need to
purchase a [Pro subscription](https://www.raycast.com/pro). The subscription also unlocks other
features such as Raycast AI, Cloud Sync, and custom themes.
##### Can I open multiple notes at the same time?
Raycast Notes is a lightweight note-taking experience and keeps your focus on a single note.
However, our navigation and search experience allows you to quickly switch notes.
##### What is the hotkey to check a task from the task list?
`⌘` `⏎` (`Ctrl` `Enter` on Windows)
##### Can I recover notes that I accidentally deleted?
Yes. Press `⌘` `K` (`Ctrl` `K` on Windows) in Raycast Notes and search for the `Show Recently
Deleted Notes` action to recover a recently deleted note.
##### Are the keyboard shortcuts the same on macOS and Windows?
Mostly, yes. The Windows shortcuts use `Ctrl` in place of `⌘` and `Alt` in place of `⌥`, with
otherwise identical key combos. The one exception worth noting is Strikethrough — on macOS you may
need to disable Speech selection in System Settings → Keyboard → Keyboard Shortcuts →
Accessibility for `⇧` `⌘` `S` to work; on Windows there's no equivalent conflict.
### Extensions
Source: https://manual.raycast.com/extensions
Description: Extensions add commands, integrations, and AI tools to Raycast — install thousands from the Store or build your own to create your perfect workflow.
Platforms: Mac, Windows
Last updated: 04 June 2026
Extensions are the building blocks of your Raycast experience. Each one adds a focused set of commands, whether that's a quick utility, a search shortcut, or a deep integration with the tools you rely on. Raycast includes a set of built-in extensions out of the box, with thousands more available in the Store.
#### Store
The Store is where you discover and install extensions built by the Raycast community, as well as private extensions if you're part of an organization. Open it using the **Store** command in Root Search.
Browse the Store by name, command, keyword, or category. Only compatible extensions for Raycast on your OS appear in results, so everything you see works on your machine. Open any extension to see its description, commands, screenshots, and author details, then press ⏎ to install. It's added to Raycast instantly, ready to use from the Store listing or from Root Search.
**Teams** If you belong to an organization on Raycast, private extensions appear in the Store alongside public ones. To find them, select **Filter by Organization** in the Navigation Bar and choose your organization. Private extensions are only visible to members and follow the same installation process as public extensions.
##### Installed Extensions
Filter the Store to show only installed extensions by opening the **Categories** dropdown in the Navigation Bar and selecting ** Installed**. From there, press `⏎` to go directly to an extension's Store listing, or open the Action Panel to view all available actionbs including uninstall, configure, or view its source code.
#### AI Extensions
AI Extensions give Raycast AI the ability to take action across your installed extensions. Instead of running a command yourself, describe what you want in [AI Chat or Quick AI](https://manual.raycast.com/ai/chat) and Raycast picks the right tool automatically — whether that's searching your clipboard history, finding a file, checking a Linear ticket, or anything else an extension supports.
Store extensions can ship AI Extensions alongside their regular commands. Raycast's own built-in extensions come with AI Extensions too. You can review and configure which tools are available to AI in **Settings → Extensions**.
Explore the [AI Extensions](https://manual.raycast.com/ai/ai-extensions) page for more information.
#### Check for Updates
Raycast automatically applies updates to your installed Store extensions in the background as they become available from the extension's maintainers. If you'd prefer to pull updates manually, or grab one the moment it's published, use the **Check for Extension Updates** command.
Automatic updates only apply to extensions installed from the Store. Local development extensions added via the **Import Extension** command are managed by you and aren't updated from the Store.
#### Create Your Own
If you can't find what you're looking for, you can build a Raycast Extension yourself. The Raycast Extension API lets you create extensions using React, TypeScript, and Node, with a built-in UI component library to get you up and running fast.
> [!NOTE]
> When you run `npm run dev` on Mac, your extension opens in Raycast v2 if it's running and falls back to Raycast v1 otherwise. Run `npm install @raycast/api@latest` to ensure your extension picks up the latest dev command behavior.
Check out the [Extension API Manual](https://developers.raycast.com) for more information.
### Translate
Source: https://manual.raycast.com/translate
Description: Translate text between dozens of languages directly from Raycast — paste, switch source and target, and copy results in seconds.
Platforms: Mac, Windows
Tier: Pro Exclusive
Last updated: 13 May 2026
The Translate command turns any block of text into another language without leaving Raycast. Open it, type or paste what you want to translate, and the result appears in real time. You can copy it, paste it directly into the app you came from, or send it to AI Chat for follow-up.
Open Translate from Root Search by typing **Translate** and pressing `↵`. For faster access, assign an alias (like `tr`) or a hotkey from the Action Panel (`⌘`/`Ctrl` `K`).
#### How It Works
When Translate is open, the window splits into a source field on top and a translated field below. As you type, edit, or paste into the source field, the translation updates automatically. Word and character counts are shown for the source text.
#### Source and Target Languages
Each side has its own language picker.
- The source language defaults to **Detect Language**, so Raycast figures out what you typed. The detected language is shown as a subtitle once it has been identified.
- The target language is whatever you set last, or the default you picked in Settings.
- To change either one, open the Action Panel and choose **Change Source Language** or **Change Target Language**. The pickers also support fuzzy search, so typing `jap` jumps to Japanese.
- Use **Swap Languages** to flip source and target. The current translation moves up into the source field, ready to translate back the other way.
#### Inline Translation
**New** You don't have to open the Translate command to translate a quick phrase. From Root Search, type your text followed by `in` or `into` and a language name, and the translation appears right in the results.
Examples:
- `hello in german`
- `"good night" into french`
The language name needs to be at least three characters and is matched fuzzily, so `jap`, `germ`, or `port` all work. Language codes (like `de` or `fr`) are intentionally **not** matched, to avoid triggering inline translation by accident.
#### Action Panel
Open the Action Panel with `⌘`/`Ctrl` `K` to see everything you can do with the current translation:
- **Copy Translation**: Copy the translated text to your clipboard. This is the default action when you press `↵`.
- **Copy Source Text**: Copy the original text instead.
- **Paste to Active App**: Paste the translation directly into the app you were just in. You can make this the default action in Settings.
- **Swap Languages**: Flip source and target.
- **Change Source Language** / **Change Target Language**: Pick a different language for either side.
- **Continue in AI Chat**: Send both the source and the translation to AI Chat as context, so you can ask follow-up questions, request a more formal tone, or get an explanation of an idiom.
#### Default Source and Target Languages
**New** If you usually translate between the same pair of languages, set them once and skip the picker every time. Open **Raycast Settings → Translator** and choose your default **Source Language** and **Target Language**. Leave the source on **Detect Language** if you'd rather have Raycast guess.
#### Use Selected Text as Source
**New** When this setting is on, launching Translate from a hotkey automatically fills the source field with whatever text you currently have selected in the foreground app. Highlight a sentence in your browser or chat app, hit your Translate hotkey, and the translation appears immediately. Toggle it in **Raycast Settings → Translator → Use Selected Text as Source**.
#### Custom Translate Commands
**New** Create your own translation commands with a fixed language pair, so you can jump straight into translating without picking languages first. For example, you might create **Translate to Spanish** or **English to Japanese**, give them their own aliases or hotkeys, and treat them like any other command in Root Search.
1. Open **Raycast Settings → Translator → Custom Commands** and click **Add Custom Command**.
2. Pick a name, a source language (or **Detect Language**), and a target language.
3. Edit, duplicate, disable, or delete custom commands from the same screen, and copy a deeplink to share or automate them.
#### Keyboard Shortcuts
- `⌘`/`Ctrl` `↵`: Run the primary action (copy or paste, depending on Settings).
- `⌥`/`Alt` `⌘`/`Ctrl` `↵`: Paste the translation into the active app.
- `⇧` `⌘`/`Ctrl` `↵`: Copy the source text.
- `⌘`/`Ctrl` `S`: Swap source and target languages.
- `⌘`/`Ctrl` `P`: Open the target language picker.
- `⇧` `⌘`/`Ctrl` `P`: Open the source language picker.
- `⌘`/`Ctrl` `K`: Open the Action Panel.
- `Escape`: Clear the source field, or close the command if it's already empty.
#### Settings
All Translate settings live under **Raycast Settings → Translator**:
- **Primary Action**: Choose whether `↵` copies the translation or pastes it into the active app.
- **Default Source Language**: The language Translate starts from. Leave it on **Detect Language** to let Raycast guess.
- **Default Target Language**: The language Translate translates into by default.
- **Use Selected Text as Source**: Auto-fill the source field with the text you currently have selected when you launch Translate from a hotkey.
- **Custom Commands**: Create, edit, and manage your own translation commands with fixed language pairs.
### Emoji & Symbols
Source: https://manual.raycast.com/emoji-symbols
Description: Find any emoji, flag, or Unicode symbol in Raycast by name, custom keyword, or natural language with AI Results, then paste it into any input field instantly.
Platforms: Mac, Windows
Last updated: 04 June 2026
**Emoji & Symbols** in Raycast lets you search for any emoji, flag, or Unicode symbol by name or description in natural language, then paste it directly into your active input field at lightning speed.
Start typing to search for emojis or symbols. Raycast matches against the symbol name, its category, and any custom keywords you've added. Use the category filters in the Navigation Bar to browse by group (Smileys & People, Symbols, Flags, and more).
You can adjust the number of columns in the Emoji view by using `⌘`/`Ctrl` `-` / `+` to decrease or increase the column count, or `⌘`/`Ctrl` `0` to return to the default, or in **Raycast Settings → Emoji & Symbols → Column Count**.
#### AI Results
AI Results uses natural language understanding to find emojis based on meaning rather than keywords. AI Results automatically show when there are no matches, or you can press `Tab` on direct matches to show AI-suggested alternatives.
#### Custom Keywords
Assign custom keywords to any emoji or symbol so you find it faster next time. You can search by Unicode name and custom keywords interchangeably.
1. Open the **Search Emoji & Symbols** command
2. Highlight the emoji you'd like to edit, then use the **Edit Custom Keywords** action from the Action Panel
3. Enter the custom keywords you'd like to assign to the emoji
4. Save the updated emoji
#### Actions
Pressing `Enter` will paste the highlighted emoji or symbol directly into your active input field. Emoji & Symbols also includes additional actions:
| Action | Mac | Windows |
| --------------------------- | ------------ | --------------- |
| Copy to Clipboard | `⌘` `Enter` | `Ctrl` `Enter` |
| Paste and Keep Window Open | `Shift` `⌘` `Enter` | `Shift` `Ctrl` `Enter` |
| Copy Unicode | `⌥` `⌘` `C` | `Shift` `Ctrl` `C` |
| Pin/Unpin Emoji | `⌘` `.` | `Ctrl` `.` |
| Assign Custom Keywords | `⌘` `E` | `Ctrl` `E` |
#### Settings
All Emoji & Symbols settings live under **Raycast Settings -> Emoji & Symbols**.
- **Column Count**: Customize how many emojis appear in the **Search Emoji & Symbols** command and choose between 6, 7, 8, 9, or 10 columns.
- **Primary Action**: Choose the primary action when pressing `⏎` in the **Search Emoji & Symbols** command.
- **Emoji Skin Tone**: Choose the default skin tone for emojis that support skin tone modifiers.
- **Save AI-generated custom keywords**: When enabled, your search term is stored as a custom keyword on the emoji you copied or pasted, helping future searches find it without AI.
##### Replace System Emoji Picker
You can replace the system emoji picker with the **Emoji & Symbols** extension in Raycast by setting a hotkey for the command.
**Mac**
1. Open **System Settings → Keyboard**
2. Select **Keyboard Shortcuts**
3. Change "Press Globe key to" to **Nothing**
4. Open **Raycast Settings → Emoji & Symbols**
5. Set the **Search Emoji & Symbols** command hotkey to `GlobeIcon`
**Windows**
1. Open **Raycast Settings → Emoji & Symbols**
2. Set the **Search Emoji & Symbols** command hotkey to `Win` `.`
#### Tips
- **Pin your favorites.** Pinned emojis always appear at the top of the grid
- **Use AI Results for discovery.** Press `Tab` to see alternative emoji suggestions for any search
- **Enable auto-save for AI keywords.** Turn on **Save AI-generated custom keywords** in **Raycast Settings** to instantly surface repeated searches using the same keywords
- **Set a global hotkey.** Assign a keyboard shortcut in settings to open Emoji & Symbols from any app. You can even reassign the built-in emoji picker hotkey on macOS and Windows to Raycast's Emoji & Symbols instead
### Calendar
Source: https://manual.raycast.com/calendar
Description: View upcoming meetings, join calls instantly, and manage your day from Raycast — a built-in calendar always one shortcut away.
Platforms: Mac
Last updated: 29 April 2026
Raycast makes it easy to check your upcoming schedule, create events, and join conference calls without switching context. Raycast's Calendar features are built on the native macOS Calendar via EventKit, so any accounts already configured in the macOS Calendar app — Google, iCloud, Microsoft/Exchange, and more — work automatically.
#### Check Your Schedule
Use the My Schedule command to quickly check your availability, block focus time, or get an overview of your day.
- The summary at the top shows your next upcoming meeting.
- The sections below are dynamic. They help you focus on the here and now: this week is represented as days, followed by sections for the next week, the rest of the month, and the upcoming months.
- Press `⌘` `K` to open the Action Panel to join conference calls, accept or decline invitations, block time, email attendees, or copy your availability.
- Use the Search Bar to filter events by title.
- Configure which calendars appear in the extension's preferences. You can fine-tune exactly which calendars show up in My Schedule.
#### Create Events
Use the Create Event command to quickly add a new event without leaving Raycast.
- Set the title, start and end times, target calendar, attendees, location, URL, notes, and reminders.
- Events are written to the macOS Calendar and sync with whichever account the chosen calendar belongs to.
#### Ask Calendar (AI)
Type `@calendar` in AI Chat to ask natural-language questions about your schedule or make changes hands-free. Examples:
- What's on my calendar tomorrow?
- Schedule a meeting with Sam at 3pm on Thursday
- Move my 2pm meeting to 4pm
- Block off Friday afternoon
- Who's attending my next meeting?
Ask Calendar can read, create, edit, and delete events on your behalf.
#### Join Events
Raycast shows your next event at the top of the root search to make it convenient to join. Just hit `⏎` to open the conference call. If a native app is installed for the conference service (for example the Zoom or Microsoft Teams desktop client), the app is opened directly without an extra browser tab.
- Google Meet links can be configured to open in a specific browser via the extension preferences — useful if you prefer Chromium-based browsers for Google features.
#### Auto-Join Events
Raycast can automatically join events when they are about to begin. When enabled, Raycast will automatically join events with meeting links in your enabled calendars that you are attending.
- Confirmation alert: by default an alert with a confirmation prompt is shown before joining. Disabling this is useful if your conferencing app already has its own confirmation screen.
- Open camera before joining: optionally open the Mac's camera (preview) just before a meeting starts, so you can check framing before you're live.
- Auto-transcribe meetings: optionally transcribe meetings automatically as they happen, with an exclusion list so specific meetings (matched by keyword) are skipped.
Auto-join is disabled initially but can be enabled in the preferences of the My Schedule command, alongside the options above.
#### Menu Bar Agenda
Raycast can show your next event in the macOS menu bar so you always know what's coming up. Configure in the Calendar extension preferences:
- Choose when to show the next event: never, always, only when an event is upcoming, or when it starts within a set number of minutes.
- Meetings only: filter out all-day and non-meeting events so only joinable meetings appear.
- Auto-hide after the event ends or after a custom number of minutes.
- Menu actions include: Open My Schedule, Open the Calendar app, Join meeting, and Dismiss event.
#### Supported Conference Providers
Raycast detects and launches conference links for the following providers from event URLs, locations, and descriptions:
- Zoom
- Google Meet
- Microsoft Teams
- Slack Huddles
- Webex
- FaceTime
- Skype
- BlueJeans
- Amazon Chime
- Whereby
- Jitsi
- Around
- Chorus
- Riverside
- StreamYard
#### Keyboard Shortcuts
- `⏎` to open the event in the macOS Calendar app
- `⌘` `⏎` to join a conference call
- `⌃` `A` to accept the event (when RSVP is pending)
- `⌃` `D` to decline the event (when RSVP is pending)
- `⌘` `⇧` `B` to block time
- `⌘` `⇧` `E` to email all attendees
- `⌃` `⌥` `A` to copy your availability
- `⌘` `.` to copy event details
- `⌘` `⇧` `.` to copy event title
- `⌘` `⇧` `,` to copy event attendees
- `⌃` `X` to delete event
#### Troubleshooting
The Calendar extension accesses the native macOS calendars. If you can't see events or can't join meetings:
1. Make sure Raycast has access to your calendars in **System Settings > Privacy & Security > Calendars**.
2. Make sure the accounts you want are set up and syncing in the native macOS **Calendar** app.
3. Make sure the individual calendars you're interested in are enabled in the Extensions Preferences of Raycast. You can fine-tune exactly which events appear in the My Schedule command.
4. If Auto-Join doesn't trigger, make sure the event has a valid conference URL in its Location, URL, or Notes field — Raycast looks for a recognised provider URL in any of these.
5. If Open-Camera-Before-Joining doesn't work, grant Raycast camera access in **System Settings > Privacy & Security > Camera**.
### Calculator
Source: https://manual.raycast.com/calculator
Description: Use Raycast's built-in calculator to do math, convert currencies and units, calculate dates, and more — right from search.
Platforms: Mac, Windows, iOS
Last updated: 13 May 2026
What's 3% of $123? In £? Invested at 7% after 3 years? No more guessing.
Raycast solves complex math expressions and supports time zones, unit conversions, dates, and currency — including crypto. The best thing is, it understands your natural language.
#### Get Started
The Calculator is a special command. It's always available in Root Search — just type any expression. You'll see your expression displayed on the left, and the answer on the right.
#### What Raycast Understands
The Calculator solves complex math expressions and supports time zones, unit conversions, dates, and currencies. Expressions now show with syntax highlighting so they're easier to read at a glance.
- Convert units and currencies like a breeze. For example, type `10ft in m` or `100 usd in gbp`.
- Get the % between two different values. For example, type `52% of 900`.
- Check the time of your teammates in different time zones. For example, type `5pm ldn in sf` or `time in tokyo`.
- Get the date for your next event, like `monday in 3 weeks`.
- Find out how many days are left in the quarter, like `days until 31 Mar`.
- Answer math questions like `square root of 625` or `2 power 10`.
- Convert a duration into a human-readable timespan, like `145 mins to timespan`.
- Plan your work week. For example, type `workhours in 2023` or `55h in workdays`.
- Convert sizes for design work. For example, type `2 inches in px at 72 ppi`.
- Solve advanced trigonometry, including `cot`, `csc`, and their hyperbolic and inverse variants like `sinh` or `acos`.
- Compare the time between you and a teammate. For example, type `time diff Paris` or the shortcut `diff Paris`.
- Find out what time it'll be after a delay. For example, type `time in 4 hours` or `time in 4 hours in San Francisco`.
- Work with ISO 8601 timestamps in Zulu format, like `2024-03-15T14:30:00Z`.
- Add days or hours to a date. For example, type `August 5 + 5` for days or `3:45pm + 5` for hours.
- Work out a discount, tip, or ratio. For example, type `20% off 80`, `15% tip on 42`, or `ratio of 3 to 5`.
- Write currency in shorthand. For example, type `USD1K` or `10K`.
- Look up times in cities, airports, and tourist destinations — including multi-word names like `time in São Paulo` or `time in JFK`.
#### Keyboard Shortcuts
- `↵` to copy the answer to your clipboard
- `⌘` `↵` (`Ctrl` `↵` on Windows) to copy the unformatted answer to your clipboard
- `⌘` `⇧` `↵` (`Ctrl` `⇧` `↵` on Windows) to copy the question and answer to your clipboard
#### Settings
The decimal separator used in the Raycast calculator is set by your system. If you want, you can change this.
1. Open your system settings and choose **Language and Region**.
2. Select **Number format** and set your preferred decimal separator and number grouping separator.
3. Your changes will be available immediately in the Raycast calculator. If they aren't, restart Raycast.
### Screenshots
Source: https://manual.raycast.com/screenshots
Description: Search and browse your screenshots instantly from Raycast — find, preview, copy, and open any capture without digging through folders.
Platforms: Mac, Windows
Last updated: 04 June 2026
The Search Screenshots command lets you find, preview, and reuse any screenshot or screen recording on your computer without leaving Raycast. Raycast indexes the contents of your screenshots with on-device OCR, so you can search by what's *in* an image, not just the filename.
Open Search Screenshots from Root Search by typing `Search Screenshots` and pressing `↵`. For faster access, assign an alias (like `sc`) or a hotkey from the Action Panel (`⌘`/`Ctrl` `K`).
A separate **Paste Latest Screenshot** command pastes your most recent screenshot directly into the active app, without opening the full view.
#### Search Filters
Combine free text with prefix-based filters to narrow your results:
- `name:` filters by filename. Example: `name:invoice`.
- `text:` filters by text recognised inside the image (OCR). Example: `text:invoice number`.
- `date:` filters by capture date using natural language. Examples: `date:yesterday`, `date:last week`.
#### Settings
- **New** **Column Count**: choose how many columns the grid in the Search Screenshots command uses: 3, 4, 5, or 6. Fewer columns mean larger thumbnails; more columns let you scan more screenshots at a glance. You can adjust the number of columns in the Search Screenshots view by using `⌘`/`Ctrl` `-` / `+` to decrease or increase the column count, or `⌘`/`Ctrl` `0` to return to the default, or in **Raycast Settings → Screenshots → Column Count**.
- **Search Scopes**: the folders Raycast watches and indexes for screenshots. Defaults include the system screenshot location (`com.apple.screencapture`), CleanShot X (`com.getcleanshot.app`), and `~/Desktop`. Use the `+` button to add more folders.
- **Include All Media**: when enabled, all images and videos in the watched folders are indexed, not just screenshots.
- **Text Recognition**: when enabled, text content in screenshots is automatically extracted (OCR) and made searchable. Required for the `text:` filter and the Copy Text from Image action.
- **Recognition Mode**: choose between **Fast** (default) and **Accurate**. Accurate catches more text but uses more CPU.
- **Allow Text Recognition for Cloud Files**: when enabled, Raycast downloads cloud-only files (e.g. OneDrive, Dropbox) so it can extract their text.
- **Storage Duration**: automatically removes older screenshots after the chosen retention window (1 Day, 1 Week, 1 Month, 3 Months, 6 Months, 1 Year, or Unlimited). Pinned screenshots are kept regardless of this setting.
- **Commands**: manage the two screenshot commands (Search Screenshots and Paste Latest Screenshot). For each one you can assign an alias, record a global hotkey, or enable/disable the command.
#### Permissions
Screenshots needs file access to read and preview images. Grant Full Disk Access in **System Settings → Privacy & Security**, or at minimum allow access to Desktop, Documents, and Downloads. Raycast prompts on first launch if permissions are missing.
### Window Management
Source: https://manual.raycast.com/window-management
Description: Manage your windows without third-party tools. Raycast's built-in window management lets you split, tile, centre, resize, and save layouts across any monitor setup.
Platforms: Mac, Windows
Tier: More with Pro
Last updated: 05 June 2026
Raycast lets you resize, organize, and move your focused window with ease—entirely from the keyboard.
[Window Management in Raycast (YouTube)](https://www.youtube.com/watch?v=Ei1RIZCrZN8)
#### Commands
Give your workspace a refresh and reorganize windows instantly:
- **Toggle Fullscreen (macOS only):** Toggles the focused window to fullscreen.
- **Maximize:** Expands the focused window to fill the whole screen.
- **Maximize Height:** Maximizes the window’s height.
- **Maximize Width:** Maximizes the window’s width.
- **Left/Right/Bottom/Top Half:** Moves the focused window to occupy half of the screen in any direction—perfect for comparing two documents.
- **Center:** Centers the focused window on the screen, maintaining its size.
- **Move Up/Down/Left/Right:** Moves the focused window to any screen edge.
- **Restore:** Restores the window to its previous size and position.
- **Reasonable Size:** Resizes the window to 60% of the screen (up to 1025x900px).
- **Move to Previous/Next Display:** For multi-monitor setups, quickly move windows between screens.
- **Move to Previous/Next Space (macOS only):** Move windows between different macOS Spaces.
- **First, First Two, Center, Last Two, Last Third:** Resize and place the window to occupy a third of the screen.
- **First, Second, Third, Last Fourth:** Move the window to one-fourth of the screen.
- **Top Left/Top Right, Bottom Left/Bottom Right Quarter:** Position the window in any quarter of the screen.
- **Top Left/Top Center/Top Right Sixth:** Align and size the window into a sixth at the top of the screen.
- **Bottom Left/Center/Right Sixth:** Align and size the window into a sixth at the bottom of the screen.
- **Open Desktop 1…9 (Windows only):** Opens a new or switches to an existing virtual desktop by number.
- **Close Desktop 1...9 (Windows only):** Closes a specified desktop.
- **Close Desktop Active (Windows only):** Closes the current virtual desktop.
- **Rename Desktop 1…9 (Windows only):** Label a specific desktop for easy reference.
- **Rename Desktop Active (Windows only):** Label your current desktop.
- **Move to Desktop 1…9 (Windows only):** Move your active window to a specified virtual desktop.
> [!TIP]
> Supercharge your routine—assign hotkeys to your most-used window management commands. For example, set a hotkey for Left Half to quickly position and resize the focused window.
#### Settings
Tailor your workspace:
- Adjust the gap between windows, or between windows and the edge of your desktop.
- Set **Left Half** and **Right Half** commands to cycle through different window sizes or even move between screens.
##### macOS
- **Respect Stage Manager:** Enable this option to ensure window management commands leave space for Stage Manager, letting you see your other open apps.
- **Presets:** Instantly apply hotkeys from other popular window management apps.
- **System Spaces Shortcuts:** Override macOS’s system keyboard shortcuts to control Raycast Window Management instead.
##### Windows
- **Auto Close Empty Desktops:** Virtual desktops are closed automatically when nothing is on them.
> [!NOTE]
> The Window Management extension needs Accessibility permissions. The first time you use a command, Raycast will prompt you to enable this in your Security & Privacy settings.
#### Custom Commands
##### Create Command
Set up personalized window commands by customizing window size, pinned position, and offsets with **Create Command**—using absolute values (points) or percentages (relative to display size).
##### Create Layout (macOS only)
Go beyond single-window commands. With **Create Layout**, set up multiple app windows on any display and optionally specify a file or link for each app to open.
##### Deeplinks
Custom commands support *Deeplinks*, which can be used outside Raycast. Create links with absolute or relative window values, for example:
```jsx
raycast://customWindowManagementCommand?&name=MyCommand&position=center&absoluteWidth=500.0&relativeHeight=0.5&absoluteXOffset=0.0&absoluteYOffset=0.0
```
| Argument | Description | Required |
|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| `name` | Command name. If a matching custom single-window command is found, other arguments are ignored. No name means a temporary command will be created. | No |
| `position` | Pin window to this position. If omitted (with a temporary command), defaults to top left. | No |
| `absoluteWidth` | Width in points. | No |
| `relativeWidth` | Width as a % of the screen width. Ignored if absolute width is set. | No |
| `absoluteHeight` | Height in points. | No |
| `relativeHeight` | Height as a % of the screen height. Ignored if absolute height is set. | No |
| `absoluteXOffset` | Horizontal offset in points. | No |
| `relativeXOffset` | Horizontal offset as a % of the screen width. Ignored if absolute x offset is set. | No |
| `absoluteYOffset` | Vertical offset in points. | No |
| `relativeYOffset` | Vertical offset as a % of the screen height. Ignored if absolute y offset is set. | No |
To create a one-time Deeplink, omit the `name`—a temporary command will be generated to position/resize the window on the fly.
For Window Layout Deeplinks, only the `name` argument is supported, so only existing window layouts can be used.
##### Additional Notes
- Custom commands currently do not support window gaps.
- With Stage Manager enabled, using Window Layout will only show the top window; as a workaround, group the apps (hold ⇧) before applying the layout, to keep all windows visible.
#### Troubleshooting
Window Management lets you resize and position windows with commands and hotkeys. Most issues come down to macOS permissions or hotkeys not firing. Here are the common ones.
##### Window commands do nothing
Window Management needs Accessibility permission. Open **System Settings → Privacy & Security → Accessibility** and make sure Raycast is enabled. If it's already listed, toggle it off and on, then restart Raycast.
##### A window-management hotkey isn't firing
Another app or a macOS shortcut may be bound to the same combination. Check for conflicts, and confirm the hotkey is set in **Raycast Settings → Window Management**. If the key is an fn/Globe or function key (F1–F12) and doesn't register, disable "Use F1, F2, etc. keys as standard function keys" in **System Settings → Keyboard → Keyboard Shortcuts → Function Keys**.
##### Windows snap to the wrong screen or size on a multi-monitor setup
Positioning is relative to the display the window is currently on. Move the window to the target display first, then run the command. For mixed-resolution or scaled displays, results can differ between screens, so set the hotkey on the screen you use most.
##### Some apps ignore resize or position commands
A few apps don't expose standard window controls to macOS (some Electron apps, full-screen apps, and apps in native full-screen mode). Take the app out of full-screen first. If it still won't resize, it likely isn't reporting a resizable window to the system.
##### Still having issues?
Send us: a screen recording, the app and the command/hotkey involved, your monitor setup, and your OS and Raycast version (**Settings → About**), plus your logs via the **Copy Raycast Logs** command.
For the screen recording, the quickest way is [ray.so/v2-record](https://ray.so/v2-record). Open the link in your browser, click record, capture what's happening, and share the resulting link in your report. No install needed.
## Power Features
### Hyper Key
Source: https://manual.raycast.com/hyper-key
Description: Give your keyboard a whole new layer of shortcuts by turning Caps Lock, a function key, or a single modifier into a dedicated Hyper Key that never clashes with your existing ones.
Platforms: Mac, Windows
Last updated: 29 May 2026
Hyper Key adds an extra modifier to your keyboard by remapping a key you don't use often. Once it's set, you can record shortcuts on top of it that won't overlap with existing system or app shortcuts. Choose from a left or right modifier, Caps Lock, or a function key.
#### Get Started
1. Open **Raycast Settings → Keyboard → Hyper Key**.
2. Pick the key you want to use — a left or right modifier, Caps Lock, or a function key.
3. Assign Hyper Key shortcuts to your favorite commands. They appear in Raycast with the ✦ glyph.
#### Settings
- **Hyper Key**: The physical key remapped to the Hyper Key modifiers. Choose **None** to turn it off, **Caps Lock** (`⇪`), any left or right modifier (`⌃` `⇧` `⌥` `⌘`, or `Ctrl` `Shift` `Alt` `Win` on Windows), or a function key (`F1`–`F12`).
- macOS Hyper Key triggers `⌃` `⌥` `⌘`
- Windows Hyper Key triggers `Ctrl` `Alt` `Win`
- **Include Shift (⇧)**: Adds Shift to the Hyper Key combo.
- **Quick Press**: Available when your Hyper Key is a non-modifier (Caps Lock or a function key). Choose what a single tap does on its own — **Does Nothing**, **Trigger** the original key (for example, send a real Caps Lock), or **Trigger Escape**.
- **Replace ⌃⌥⌘ with ✦**: Shown when no Hyper Key is set. Raycast still displays your existing `⌃` `⌥` `⌘` (or `Ctrl` `Alt` `Win`) shortcuts using the `✦` glyph in Root Search.
#### Troubleshooting
If your Hyper Key isn't firing, first make sure no other app is mapping the same physical key. Karabiner-Elements virtual keyboards, exclusive HID drivers, and other keyboard utilities can intercept the key before Raycast sees it . Turn tehse off and try again.
On macOS, Raycast includes a built-in diagnostic. From **Raycast Settings → Keyboard** with a Hyper Key configured, press the green dot to reveal the **Hyper Key Diagnostic** panel. It shows whether the Hyper Key is currently active, which key it's bound to, and any conflicts it detects, such as other apps, Karabiner, exclusive HID access, or Caps Lock mapping. Use the `↻` button next to **Active** to restart Hyper Key without quitting Raycast.
#### FAQ
##### Why doesn't Hyper Key work in password fields on macOS?
This is a macOS limitation. Password fields use secure input, which apps can't monitor for security reasons. The only way around it would be to load a kernel driver, which we won't do. It only affects macOS.
##### Why isn't Hyper Key working with Caps Lock on macOS?
Open **System Settings → Keyboard → Keyboard Shortcuts… → Modifier Keys** and make sure the Caps Lock action is set to **Caps Lock** (not **No Action** or anything else). The Hyper Key Diagnostic panel flags this as a Caps Lock Mapping Conflict and includes a button that jumps straight to the right macOS setting. If it still doesn't work, copy the log file from the diagnostic panel and send it through **Send Feedback**.
### Dynamic Placeholders
Source: https://manual.raycast.com/dynamic-placeholders
Description: Insert clipboard contents, dates, cursor position, and calculated values automatically into Snippets and Quicklinks with Dynamic Placeholders.
Platforms: Mac, Windows
Last updated: 29 April 2026
You can make your Quicklinks, Snippets, and AI Commands dynamic with placeholders. The supported placeholders are:
| Name | Placeholder | Description |
| --- | --- | --- |
| Clipboard Text | `{clipboard}` | Inserts your last copied text. The placeholder is removed if no text has been copied recently. |
| Snippets | `{snippet name="…"}` | Inserts the content of the referenced snippet. Only snippets that don't reference other snippets can be inserted. |
| Cursor Position ¹ | `{cursor}` | Moves the cursor to this position when pasted or injected. A snippet can contain only one `{cursor}` placeholder. |
| Date ¹ ³ | `{date}` | Inserts the current date, e.g. 1 Jun 2022. |
| Time ¹ ³ | `{time}` | Inserts the current time, e.g. 3:05 pm. |
| Date & Time ¹ ³ | `{datetime}` | Inserts both date and time, e.g. 1 Jun 2022 at 6:45 pm. |
| Weekday ¹ ³ | `{day}` | Inserts the day of the week, e.g. Monday. |
| UUID ¹ ³ | `{uuid}` | Inserts a universally unique value, e.g. `E621E1F8-C36C-495A-93FC-0C247A3E6E5F`. |
| Selected Text ² ³ | `{selection}` | Inserts the selected text from the frontmost application. In AI Chat, the previous message is inserted instead. |
| Argument | `{argument}` | Prompts for input in the search bar. Replaced by the argument's value. You can add a maximum of 3 different arguments. |
| Calculator ¹ ² ³ | `{calculator}` | Evaluates a math expression. |
| Focused Browser Tab ² ⁴ | `{browser-tab}` | Inserts the content of the focused browser tab. |
¹ Only available in Snippets
² Only available in AI Commands
³ Only available in Quicklinks
⁴ Only available when the [Browser Extension](https://raycast.com/browser-extension) is installed
#### Modifiers
Using modifiers, you can transform the value of a placeholder with the `{clipboard | uppercase}` syntax. Modifiers work on all placeholders.
Available modifiers:
- `uppercase` → transforms `Foo` into `FOO`
- `lowercase` → transforms `Foo` into `foo`
- `trim` → transforms ` Foo Bar ` into `Foo Bar` — removes whitespace from the beginning and end
- `percent-encode` → transforms `Foo Bar` into `Foo%20Bar` — replaces [special characters](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding) with percent-encoded equivalents
- `json-stringify` → transforms `Foo "Bar"` into `"Foo \"Bar\""` — ensures the value can be safely used as a JSON string
You can chain multiple modifiers: `{clipboard | trim | uppercase}`.
Depending on where the placeholder is used, Raycast may apply default formatting automatically:
- **Quicklinks** → Special characters are percent-encoded to keep the link valid.
- **AI Commands** → Placeholders are wrapped with `"""` to delimit them for the AI.
To opt out of this default formatting, use the `raw` modifier: `{clipboard | raw}`.
#### Date & Time Offset
By default, date and time placeholders use the current date/time when the snippet is inserted. To use a relative date/time, add an offset modifier.
An offset modifier has three parts:
- A `+` or `-` sign for the direction
- A number
- A unit letter: `m` (minutes), `h` (hours), `d` (days), `M` (months), `y` (years)
> [!NOTE]
> `m` (lowercase) is minutes and `M` (uppercase) is months. All units are case-sensitive.
Separate the modifier from the keyword with spaces. You can combine multiple offsets in a single placeholder:
- `{date offset="+2y +5M"}`
- `{time offset="+3h +30m"}`
- `{day offset=-3d}`
- `{datetime offset=+1h}`
> [!NOTE]
> There must be no space after the sign. `{date offset="+ 2d"}` is not valid — the correct form is `{date offset="+2d"}`.
When you type a valid placeholder, the curly braces turn blue. If the keyword or modifier is unrecognized, the braces remain unstyled.
#### Custom Date Formats
The default format of date/time placeholders follows your system preferences. You can create a custom format with `{date format="yyyy-MM-dd"}`.
| Placeholder | Output |
| --- | --- |
| `{date format="EEEE, MMM d, yyyy"}` | Wednesday, Jun 15, 2022 |
| `{date format="MM/dd/yyyy"}` | 06/15/2022 |
| `{date format="MM-dd-yyyy HH:mm"}` | 06-15-2022 13:44 |
| `{date format="MMM d, h:mm a"}` | Jun 15, 1:44 PM |
| `{date format="MMMM yyyy"}` | June 2022 |
| `{date format="MMM d, yyyy"}` | Jun 15, 2022 |
| `{date format="E, d MMM yyyy HH:mm:ss Z"}` | Wed, 15 Jun 2022 13:44:39 +0000 |
| `{date format="yyyy-MM-dd'T'HH:mm:ssZ"}` | 2022-06-15T13:44:39+0000 |
| `{date format="dd.MM.yy"}` | 15.06.22 |
| `{date format="HH:mm:ss.SSS"}` | 13:44:39.945 |
Notes:
- You can mix date modifiers with custom formats: `{date format="yyyy-MM-dd" offset="+3M -5d"}`.
- All characters inside the format string are **case-sensitive**.
- Wrap literal text in single quotes to include it verbatim: `{date format="h:mm 'on the eve of' MMMM d"}` outputs **8:30 on the eve of June 5**.
##### Reference for supported alphabets in custom date format
The following table contains the alphabets you can use in a custom date format and their output. Examples are based on June 15th, 2022 2:45 PM UTC.
> [!NOTE]
> All letters within the double quotes are case-sensitive.
| Alphabet | Output | Description |
| --- | --- | --- |
| **YEAR** | | |
| `y` | 2022 | Year, no padding |
| `yy` | 22 | Year, two digits (padding with a zero if necessary) |
| `yyyy` | 2022 | Year, minimum of four digits (padding with zeros if necessary) |
| **QUARTER** | | |
| `Q` | 2 | The quarter of the year. Use `QQ` if you want zero padding. |
| `QQQ` | Q2 | Quarter including "Q" |
| `QQQQ` | 2nd quarter | Quarter spelled out |
| **MONTH** | | |
| `M` | 6 | The numeric month of the year. A single `M` will use '6' for June. |
| `MM` | 06 | The numeric month of the year. A double `MM` will use '06' for June. |
| `MMM` | Jun | The shorthand name of the month |
| `MMMM` | June | Full name of the month |
| `MMMMM` | J | Narrow name of the month |
| **DAY** | | |
| `d` | 15 | The day of the month. A single `d` will use 1 for June 1st. |
| `dd` | 15 | The day of the month. A double `dd` will use 01 for June 1st. |
| `F` | 3 | The day of week in month (numeric). |
| `E` | Wed | The abbreviation for the day of the week |
| `EEEE` | Wednesday | The wide name of the day of the week |
| `EEEEE` | W | The narrow day of week |
| `EEEEEE` | We | The short day of week |
| **HOUR** | | |
| `h` | 2 | The 12-hour hour |
| `hh` | 02 | The 12-hour hour, padded with a zero if there is only 1 digit |
| `H` | 14 | The 24-hour hour |
| `HH` | 14 | The 24-hour hour, padded with a zero if there is only 1 digit |
| `a` | PM | AM / PM for 12-hour time formats |
| **MINUTE** | | |
| `m` | 45 | The minute, with no padding for zeroes |
| `mm` | 45 | The minute with zero padding |
| **SECOND** | | |
| `s` | 6 | The seconds, with no padding for zeroes |
| `ss` | 06 | The seconds with zero padding |
| `SSS` | 753 | The milliseconds |
| **TIME ZONE** | | |
| `zzz` | IST | The 3-letter name of the time zone. Falls back to GMT-08:00 if the name is not known. |
| `zzzz` | Indian Standard Time | The expanded time zone name. Falls back to GMT-08:00 if name is not known. |
| `ZZZZ` | IST+05:30 | Time zone with abbreviation and offset |
| `Z` | +0530 | RFC 822 GMT format. Can also match a literal Z for Zulu (UTC) time. |
| `ZZZZZ` | +05:30 | ISO 8601 time zone format |
You can read more about date format patterns in the [Unicode Date Format Patterns reference](https://www.unicode.org/reports/tr35/tr35-31/tr35-dates.html#Date_Format_Patterns).
#### Arguments
##### Argument Name
By default, each `{argument}` placeholder creates a new input field in the search bar (up to 3). To reuse the same value across multiple placeholders, give them the same name: `{argument name="tone"}`. Placeholders with matching names are replaced by the same value.
##### Argument Default Value
By default, an argument is required and the command cannot run until a value is entered. To make it optional, set a default value: `{argument default="happy"}` or `{argument name="sport" default="skiing"}`.
##### Argument Options
To present a predefined set of choices, use the `options` parameter: `{argument name="tone" options="happy, sad, professional"}`.
#### Clipboard Offset
By default, `{clipboard}` inserts your most recently copied text. To access older clipboard entries, use an offset:
- `{clipboard offset=1}` → second most recent
- `{clipboard offset=2}` → third most recent
> [!NOTE]
> Using a clipboard offset placeholder requires Clipboard History to be enabled.
#### Browser Tab
##### Browser Tab Format
By default, the tab content is converted to Markdown. You can specify a different format:
- `{browser-tab format="markdown"}` — default
- `{browser-tab format="text"}` — plain text content of the tab, without any styling
- `{browser-tab format="html"}` — full HTML content of the tab
##### Browser Tab Selector
To extract a specific part of the page, use a CSS selector: `{browser-tab selector="a.author.text-bold"}`. This lets you create highly targeted commands for specific websites.
### System Commands
Source: https://manual.raycast.com/system-commands
Description: Control your system from Raycast — lock the screen, sleep, restart, empty the trash, toggle Wi-Fi, and run dozens of system actions instantly.
Platforms: Mac, Windows
Last updated: 29 April 2026
System Commands give you a Raycast command for the actions you'd otherwise dig through menu bars, system menus, or keyboard shortcuts for. Lock the screen, restart, toggle the system appearance, mute the volume; they're all one search away, and pair perfectly with hotkeys and aliases.
#### Discover System Commands
System Commands are organised into the **System Actions** built-in extension. They're available out of the box on both Mac and Windows, with a few platform-specific extras on each.
##### Power & Session
- **Lock Screen**: Lock the screen of your computer.
- **Sleep**: Put your computer to sleep.
- **Hibernate** (Windows): Hibernate your computer.
- **Sleep Displays**: Put the displays of your computer to sleep.
- **Restart**: Restart your computer.
- **Shut Down**: Shut down your computer.
- **Log Out**: Log out from the current user.
- **Show Screen Saver**: Start the screen saver.
##### Audio & Media
- **Play / Pause**: Play or pause the current track.
- **Next Track**: Play the next track.
- **Previous Track**: Play the previous track.
- **Toggle Mute**: Mute or unmute your computer's speaker.
- **Turn Volume Up** / **Turn Volume Down**: Step the volume up or down.
- **Set Volume**: Set the volume to a specific value.
- **Set Volume to 0% / 25% / 50% / 75% / 100%**: Jump straight to a preset level.
##### Display & Appearance
- **Show Desktop**: Hide every window and reveal the desktop.
- **Toggle System Appearance**: Switch between light and dark mode.
- **Toggle Stage Manager** (Mac): Turn Stage Manager on or off.
- **Toggle HDR** (Windows): Turn HDR on or off.
- **Toggle Night Light** (Windows): Turn Night Light on or off.
##### Files & Storage
- **Open Trash**: Open the Trash in Finder or File Explorer.
- **Empty Trash**: Empty the Trash.
- **Eject All Disks** (Mac): Eject every mounted disk image.
- **Toggle Hidden Files**: Show or hide hidden files in the file browser.
##### Apps & Notifications
- **Hide All Apps Except Frontmost**: View the front app and hide everything else.
- **Unhide All Hidden Apps** (Mac): Bring every hidden app back into view.
- **Quit All Apps**: Quit every running application.
- **Quit All Apps Except Frontmost**: Same as above, but keep the front app open.
- **Dismiss Notifications** (Mac): Clear every notification on screen.
##### Connectivity
- **Toggle Bluetooth**: Turn Bluetooth on or off.
#### Using System Commands
Search for any System Command in Root Search and hit `Enter` to run it. Most are one-shot, with no follow-up screen, the action just happens.
System Commands shine when you assign them aliases or hotkeys. Open any command's action panel and choose **Configure Command** (or see [Aliases & Hotkeys](https://manual.raycast.com/command-aliases-and-hotkeys)) to set:
- An **Alias** so typing `lock`, `mute`, or `restart` jumps straight to the command.
- A **Hotkey** for true one-press triggering, even when Raycast isn't open.
Common patterns:
- **Lock Screen** with a global hotkey for stepping away from your machine.
- **Toggle System Appearance** on a hotkey for quick light/dark switching.
- **Toggle Mute** on a hotkey when you join a call from any app.
- **Empty Trash** with the alias `et` for occasional clean-ups.
#### Quit All Apps
- **Show warning before quitting applications**: When enabled (default), Raycast asks for confirmation before quitting everything. Disable it for instant quitting.
- **Excluded Applications**: A list of apps that should stay open when you run **Quit All Apps**. Useful for keeping browsers, music players, or chat apps running while clearing everything else.
The same preferences apply to **Quit All Apps Except Frontmost**.
### Script Commands
Source: https://manual.raycast.com/script-commands
Description: Turn your scripts into Raycast commands with Script Commands. Run Bash, Python, Ruby, Swift, AppleScript, and more to automate any workflow.
Platforms: Mac, Windows
Last updated: 06 May 2026
Script Commands let you tailor Raycast to your needs. They allow you to run your frequently used scripts in a few keystrokes, or bind them to a hotkey.
Script Commands let you bring your own automation into Raycast by writing simple scripts in any language you prefer, whether it's C#, Bash, PowerShell, Python, Node.js, or others. Define a title, description, and other metadata at the top of your script file, and Raycast turns it into a fully searchable command, just like a built-in one.
Quickly create a new script with **Create Script Command** or import existing scripts by adding a **Script Directory** from Settings. You can learn more about the metadata format in the [Script Commands repo](https://github.com/raycast/script-commands#metadata).
#### Overview
Reach for a Script Command when you want to:
- Trigger a system action you do all day: toggle hidden files, switch audio output, eject all disks.
- Run a personal dev workflow: kick off a deploy, open the staging dashboard, paste a templated commit message.
- Talk to home automation, IoT, or an internal API without writing a full extension.
- Turn ten lines of shell or Python into a first-class Raycast command.
#### Adding Script Commands
##### Create a new script
Open Raycast, run **Create Script Command**, pick a language template, and Raycast scaffolds a new file with the metadata header pre-filled. Save it to any folder you've added as a Script Directory.
##### Import existing scripts
Open **Raycast Settings → Script Commands → Add Script Directory** and pick any folder. Raycast indexes every script file inside it as a command. Edits to a script's metadata (rename, add an argument, change mode) are picked up automatically — no restart needed.
For the full metadata reference (directives, modes, arguments, refresh time, and language-specific examples), see the [Script Commands repo](https://github.com/raycast/script-commands).
#### Tips
##### Bind frequently-used scripts to a hotkey
Any Script Command can be triggered from a global hotkey. Find your script in Root Search, press `⌘`/`Ctrl` `K` to open the Action Panel, pick **Configure Command**, then **Record Hotkey**. Now the script runs from anywhere on your system, even when Raycast isn't open.
##### Keep scripts idempotent
If a script will be triggered repeatedly (especially from a hotkey or a refresh interval), make it safe to run twice in a row. Toggle commands beat on/off pairs; "ensure X exists" beats "create X".
#### Platform Support
##### macOS
_(Only on Mac)_
On macOS, Script Commands run with whatever interpreter your shebang points to. Built-in support covers AppleScript (`.applescript`, `.scpt`), shell (`bash`, `zsh`), Python, Node.js, Ruby, PHP, and Swift.
> [!TIP]
> The first time a script touches Accessibility, Automation, or Full Disk Access, macOS shows a system permission prompt. Grant it to the **Raycast** app, not Terminal — Raycast is the process running the script.
> [!TIP]
> For AppleScript, prefer `.applescript` over compiled `.scpt` when you can. Plain text plays nicer with version control and is much easier to diff and review.
##### Windows
_(Only on Windows)_
On Windows, Script Commands run with whatever interpreter is on your PATH. Common runtimes include PowerShell (`.ps1`), C#, Python, Node.js, and Bash (under WSL or Git Bash).
> [!TIP]
> If a `.ps1` script won't run, check your PowerShell execution policy with `Get-ExecutionPolicy`. The default `Restricted` blocks every script; `RemoteSigned` is the usual setting for personal machines.
> [!TIP]
> Forward slashes work in most paths and survive copy/paste between machines better than backslashes. Prefer `C:/Users/you/scripts/foo.ps1` over the escaped backslash form.
#### Learn More
For the full metadata reference and examples in every supported language, see the [Script Commands repo](https://github.com/raycast/script-commands).
Here are two example scripts to get you started:
##### Build Xcode
_(Only on Mac)_
```bash
#!/bin/bash
# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title Build XCODE
# @raycast.mode compact
# Optional parameters:
# @raycast.icon 🤖
osascript <<'EOF'
tell application "Xcode"
activate
end tell
tell application "System Events"
tell process "Xcode"
keystroke "r" using {command down}
end tell
end tell
EOF
```
##### Open in CleanShot X
_(Only on Mac)_
```bash
#!/bin/bash
# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title Open in CleanShot X
# @raycast.mode silent
# Optional parameters:
# @raycast.icon 🖼️
# @raycast.packageName Finder
# Documentation:
# @raycast.description Opens the currently selected Finder file with CleanShot X
selected_file=$(osascript -e '
tell application "Finder"
if (count of (selection as alias list)) > 0 then
set selectedItem to item 1 of (selection as alias list)
return POSIX path of (selectedItem as text)
else
return ""
end if
end tell
')
if [ -z "$selected_file" ]; then
echo "No file selected in Finder."
exit 1
fi
open -a "CleanShot X" "$selected_file"
echo "Opened $(basename "$selected_file") in CleanShot X"
```
#### Troubleshooting
For issues with Script Commands, refer to the [troubleshooting and FAQs](https://github.com/raycast/script-commands#troubleshooting-and-faqs) section in the Script Commands repo.
### Themes
Source: https://manual.raycast.com/themes
Description: Customise how Raycast looks with Themes — choose from a curated collection or design your own in Theme Studio with custom backgrounds, colours, and more.
Platforms: Mac, Windows
Tier: Pro Exclusive
Last updated: 29 April 2026
**Themes** let you customize the look and feel of Raycast to match your vibe. You can adjust the background, primary text, and support colors, which adapts across Raycast in Light and Dark mode.
#### Theme Studio
Theme Studio is the built-in editor where you can choose from a curated collection of included themes, tweak existing ones to suit your preferences, or design a completely custom theme from scratch. Every color adjustment is previewed in real-time, so you can see exactly how your changes will look before applying them.
When creating a custom theme in Theme Studio, you can:
- Name your theme and select whether it is a Light or Dark mode theme
- Adjust the appearance, including background color or gradient, primary colors, and support colors. You can paste hex values directly or pick colors using the color picker.
- Save your theme or copy as URL to share with others.
You can also right-click a theme in the sidebar to see more options such as set as Light or Dark mode theme, duplicate, copy as JSON, or delete theme.
#### Switch Theme Command
Use the **Switch Theme** command to browse all installed themes and apply one as your current theme. You can also use the **Set as Light Theme** or **Set as Dark Theme** actions in the Action Panel to adjust your theme settings separately for each system appearance.
#### Theme Settings
Theme preferences can be found in the Appearance section under General in **Raycast Settings**. From here, you can browse and switch between installed themes, set separate themes for Light and Dark Mode, and open Theme Studio.
#### Share & Import Themes
Themes are shared as URLs that encode their colors, appearance, and creator information. Export a theme from Theme Studio by right-clicking it in the sidebar and selecting **Copy as URL** to share a [themes.ray.so](https://themes.ray.so) link, or **Copy as JSON** to copy the theme data to your clipboard.
Browse community-created themes at [**themes.ray.so**](https://themes.ray.so) and click **Add to Raycast** on any theme.
### Auto Quit
Source: https://manual.raycast.com/auto-quit
Description: Free up memory by quitting apps automatically after a period of inactivity. Select the apps, set a timeout, and Raycast handles the rest.
Platforms: Mac
Last updated: 14 May 2026
Some apps you only check occasionally, but they sit open all day eating memory anyway. Auto Quit closes them a few minutes after you stop using them and gets out of your way until you open them again. Pick the apps, set a timeout, and Raycast handles the rest.
#### Get Started
1. Open Raycast and search for an app you'd like to configure with **Auto Quit**.
2. Press `⌘` `K` to open the Action Panel and select **Enable Auto Quit**.
3. The next time the app sits in the background for 3 minutes (by default), Raycast quits it.
To turn it off, select **Disable Auto Quit** from the Action Panel when viewing the app in Root Search. You can also add or remove apps directly in **Raycast Settings → Applications → Auto Quit**.
#### Manage Auto Quits
All Auto Quit settings live under **Raycast Settings → Applications → Auto Quit**. From here you can change the default duration for all apps, set a different timeout per app, and add or remove apps from the list.
##### Duration
The **Default Auto Quit Duration** is the timeout used when you use **Enable Auto Quit** from the Action Panel. Pick from **1**, **3** (Default), **5**, **10**, or **15 minutes**. Changing the default also updates every app currently using it. One change adjusts your whole list at once.
Each app can have its own timeout instead of following the default. Apps still using the default show a **Default** label next to their interval, making it clear which ones will update when you change it.
##### Add or Remove Apps
Click the **plus button** button at the top of the settings page to add an app, or the **minus button** button beside any app to remove its rule. You can also toggle Auto Quit for any app from Root Search using the **Enable Auto Quit** / **Disable Auto Quit** action.
#### When Auto Quit Waits
Auto Quit avoids closing apps in situations where it would interrupt you. When any of these apply, the timer reschedules itself and tries again later:
- The system is **recording audio or video**. Auto Quit pauses for every scheduled app while a recording is active.
- **Spotify** or **Apple Music** is playing. The player keeps running until playback stops.
- The app is **currently frontmost**. The timer is reset while you're in the app and starts again when it's hidden or deactivated.
Background-only apps, such as menu bar utilities, daemons, and similar, usually never trigger an Auto Quit because they don't go through the active/inactive lifecycle the timer listens for.
> [!NOTE]
> Raycast and Finder are always excluded from Auto Quit, even if you try to enable it on them.
#### Tips
- Pair Auto Quit with [**Quit All Apps**](https://manual.raycast.com/system-commands#quit-all-apps) for an end-of-day reset. **Quit All Apps** clears everything in one shot, while Auto Quit handles stragglers throughout the day.
- Avoid Auto Quit for apps that need to keep running, such as sync clients or mail apps you rely on for notifications, or music players you control from elsewhere.
### Run
Source: https://manual.raycast.com/run
Description: Replace the Windows Run dialog with Raycast — launch apps, Control Panel applets, MMC snap-ins, paths, and shell URIs by name.
Platforms: Windows
Last updated: 28 May 2026
Run is a modern replacement for the classic Windows Run dialog. Instead of memorising commands, you can browse, discover, and run everything your system offers, directly from Raycast.
#### Getting Started
1. **Open Raycast** and search for **Open Run**.
2. **Browse or type**: Start typing or choose from previously run commands. Applications, system tools, Control Panel applets, Management Console, paths, and registered URIs you've run before will appear here as well.
3. **Execute**: Press `Enter` to run the selected item. Raycast records it in your history so you can rerun it later.
> [!TIP]
> Prefer to skip the list? Use **Execute Run Command** from root search: press `Tab` to enter a command and run it instantly, when you know exactly what you need to launch.
##### Commands
- **Open Run** – Browse and execute Windows commands, applications, Control Panel applets, MMC snap-ins, directories, and shell URIs. Your Run history is displayed in this command
- **Execute Run Command** – Run a Windows command directly from root search using `Tab`
- **Search Run Commands** – Browse and manage your custom Run Command aliases
- **Create Run Command** – Create a custom Run Command with an alias, icon, description, tags, and optional shell override
##### Capabilities
With Raycast Run, you can:
- Search and launch applications and system tools (`notepad`, `calc`, `regedit`, `taskmgr`)
- Open Control Panel applets and MMC snap-ins (`appwiz.cpl`, `certmgr.msc`, `diskmgmt.msc`)
- Navigate to directories using paths, network shares, and environment variables (`C:\Users`, `\\server\share`, `%appdata%`)
- Execute shell URIs to access special locations (`shell:Recent`, `shell:startup`, `shell:RecycleBin`)
- Access and manage your run history with full backwards compatibility with the Windows Run dialog
#### How Run Works
Run classifies what you type into one of these kinds:
- **Executable** – `.exe`, `.cmd`, `.bat`, `.com`, or an unrooted command like `notepad`
- **Control Panel Applet** – `.cpl` files such as `appwiz.cpl` or `ncpa.cpl`
- **Management Console** – `.msc` snap-ins such as `certmgr.msc` or `diskmgmt.msc`
- **Environment Variable** – `%VAR%` style values such as `%APPDATA%`
- **Path** – Rooted drive paths (`C:\Users`), UNC paths (`\\server\share`), and env-var paths (`%appdata%\Microsoft`)
- **URI** – Registered schemes like `shell:Recent`, `shell:startup`, or `ms-settings:`
- **Run Command** – Custom aliases you've created
History is shared with the built-in Windows Run dialog, so anything you've run there shows up here, and anything you run from Raycast stays available in both places.
##### Run Commands
Run Commands are custom aliases for frequently used commands you build on top of anything Run already knows how to execute. A Run Command includes:
- Alias & Icon
- Description (optional)
- Command
- Tags (optional)
- Shell (defaults to system shell)
- Non-default shells may not support URI commands, Control Panel applets, or Management Consoles.
Once saved, a Run Command appears in root search under its alias and in the **Open Run** list. You can create one at any time from the **Create Run Command** command or from the action in the action panel.
#### Tips
- Bind **Open Run** to `Win` `R` to replace the built-in Windows Run dialog with the Run commands in Raycast
- Use the **Run as Administrator** action with a Run Command or executable selected to run with elevated permissions
- Use the **Delete from History** action on any History entries in the **Open Run** command to remove it from both Raycast and Windows Run history
### Games
Source: https://manual.raycast.com/games
Description: Launch every game on your PC from Raycast — automatically discovers titles from Steam, Epic, GOG, and more, with Game Mode to silence hotkeys while you play.
Platforms: Windows
Last updated: 28 May 2026
Games turns Raycast into a single launcher for the games installed on your PC. Grouped with your apps, per-game actions for launching, and smart enough to step out of the way while you play by silencing global hotkeys in Game Mode.
#### Getting Started
- Open **Raycast Settings → Games**. The extension is enabled by default. If you've disabled it previously, toggle it on in the top right.
- Type a game's name in root search to Open it.
- (Optional) On the Games settings page, turn on **Game Mode** to pause Raycast hotkeys while a game window is detected in the foreground.
#### Discovery
When Raycast is open on your system, it will automatically scan your system for games installed through the following launchers:
- Steam
- Epic Games Launcher
- GOG Galaxy
- Battle.net
- Ubisoft Connect
- EA (EA app / Origin)
- itch.io
- Xbox app (Microsoft Store / MSIX titles)
- NVIDIA GeForce NOW
In addition to these launchers, Raycast will treat any app as a game when registered with Windows' Game Config Store.
##### Game Mode
When Game Mode is enabled, Raycast monitors the active foreground window. If it detects a game (either from Raycast's classification, the Windows Game Config Store, or a full-screen exclusive Direct3D window), it temporarily pauses all Raycast hotkeys. As soon as you switch windows or the game loses focus, hotkeys are resumed.
> [!NOTE]
> Game Mode only pauses hotkeys for the active window. Running a game in the background won't pause the Raycast hotkeys.
#### Tips
Search "Games" in Raycast to view all your games and game launchers. If a game is mistreated as an Application, press `Ctrl` `K` and select **Mark as Game** to update the classification. You can also use this to reclassify Applications that are incorrectly marked as Games.
#### FAQ
##### Do I need to connect Raycast to the launchers?
No. Game discovery is local on your system and Raycast reads installed-game metadata from disk and the registry, not from online libraries.
##### What exactly does Game Mode do?
It pauses all hotkeys, including the Raycast hotkey, whenever a game window is in the foreground. As soon as the game window loses focus, hotkeys are resumed.
##### Can I exclude a specific game from Game Mode?
Not directly. The best option to do this would be to reclassify the game as an application by using the **Treat as Application** action. Once an item is reclassified as a regular app, it no longer trips the foreground-game check.
##### Why don't I have the Games settings page?
The Games settings page (and Game Mode) is only shown in Raycast for Windows version 0.35 and above. On macOS, there's no Games extension to configure.
## AI
### AI
Source: https://manual.raycast.com/ai
Description: Raycast AI brings leading models and powerful extensions to Mac, Windows, and iOS — chat, draft, research, and code without leaving your current context.
Platforms: Mac, Windows, iOS
Tier: More with Pro
Last updated: 04 June 2026
Raycast AI combines leading models with powerful extensions, accessible across your operating system. From drafting content to researching ideas to debugging code, Raycast AI adapts to your needs without leaving your current context.
> [!NOTE]
> More AI features are on the way in Raycast. As we continue to strive for feature parity on Windows, all of our AI features will also be made available in the near future.
- [Chat](https://manual.raycast.com/ai/chat): Start a conversation with Raycast AI
- [Dictation](https://manual.raycast.com/ai/dictation): Speech to text, anywhere on your system
- [AI Commands](https://manual.raycast.com/ai/ai-commands): Turn favorite prompts into one-press commands
- [AI Extensions](https://manual.raycast.com/ai/ai-extensions): Talk to extensions, get things done
- [Agents](https://manual.raycast.com/ai/agents): Save reusable AI setups for recurring tasks
- [Skills](https://manual.raycast.com/ai/skills): Give Raycast AI reusable instructions and knowledge
- [Personalization](https://manual.raycast.com/ai/personalization): Customize your Raycast AI experience
- [Usage Limits](https://manual.raycast.com/ai/usage-limits): Understand your AI request limits
- [Bring Your Own Keys](https://manual.raycast.com/ai/bring-your-own-keys): Use your own Anthropic, Google, or OpenAI key
- [Model Context Protocol](https://manual.raycast.com/ai/model-context-protocol): Connect MCP servers to extend Raycast AI
- [Privacy & Security](https://manual.raycast.com/ai/raycast-ai-privacy-security): See how we protect your data
### Chat
Source: https://manual.raycast.com/ai/chat
Description: AI Chat lets you have ongoing conversations, while Quick AI gives you instant answers in the launcher. From drafting content to researching ideas to debugging code, Chat adapts to your needs to get more done.
Platforms: Mac, Windows, iOS
Tier: Free during Beta
Last updated: 04 June 2026
Raycast offers two ways to work with an AI model. **Quick AI** handles fast, one-off questions straight from Root Search, while **AI Chat** is a full multi-turn conversation interface with persistent history, Agents, memory, attachments, and tool use. Together they cover everything from a quick lookup to a longer working session, all without leaving Raycast.
#### Models
Configure the AI models used across Quick AI, AI Chat, and Custom AI Commands from **Raycast Settings → AI → Models**, or use the **Manage Models** command to jump straight there.
##### Default Models
Pick the default model for each surface:
- **Quick AI**: the model used when you ask a quick question from Root Search.
- **AI Chat**: the default for new chats. Set to **Last Used Model** to continue with whichever model you used most recently.
- **Custom AI Commands**: the default for any AI Command that doesn't specify its own model.
##### Manage Models
Choose which models appear in the model pickers across Quick AI, AI Chat, and Custom AI Commands:
- **Review model details**: each model lists its Speed, Intelligence, and Context window so you can compare capabilities at a glance.
- **Enable or disable models**: toggle the checkbox next to a model to control whether it shows up in pickers. Disabled models are hidden everywhere AI models can be selected.
- **Group by Provider**: models are grouped by their provider (e.g. Raycast, Anthropic). Expand or collapse a provider to focus on a subset.
- **Sort the list**: use the sort menu in the top-right to order models by Brand, Alphabetically, Speed, Intelligence, or Context Window.
#### Quick AI
_(Available on Mac and Windows)_
Quick AI is the fastest way to ask a one-off question from Raycast, without leaving your flow. Start from Root Search, hit `Tab`, and get an answer in the same window.
**New** Quick AI now uses a chat-style interface with follow-ups, context attachments, and a one-keystroke handoff to AI Chat.
##### Open Quick AI
There are three ways to start:
- From Root Search: start typing your question, then press `Tab`. Raycast hands your text to Quick AI and submits it.
- Run the **Quick AI** command directly from Root Search to open with an empty prompt.
- Set Quick AI as a fallback command in **Raycast Settings → Launcher → Fallback Commands** to send any unmatched Root Search text straight to Quick AI when you press `↵`.
Pressing `Tab` from Root Search always opens Quick AI, even with no text typed, so you can start fresh.
##### Ask a Question
Type your prompt and press `↵` to submit. Quick AI streams the answer back in the same window.
On the response, `↵` pastes the answer into the previously focused app by default. To swap the default to copy instead, open **Raycast Settings → AI → Commands → Quick AI → Primary Action**.
When a response includes code, it appears in a code block with the detected language and a copy button. Long lines scroll sideways by default. Click **Enable line wrap** in the top right of the block to wrap them to the response width, and click again to switch back.
##### Follow-ups
Keep typing after a response to ask a follow-up. Quick AI is a full conversation, not a single-shot Q&A.
- Regenerate the last response with the same model: `⌘`/`Ctrl` `R`
- Regenerate the last response with a different model: `⇧` `⌘`/`Ctrl` `R`
- Start a fresh conversation: `⌘`/`Ctrl` `N`
- Navigate between recent Quick AI chats: `⌘`/`Ctrl` `[` and `⌘`/`Ctrl` `]`
##### Switch Models
Open the Action Panel (`⌘`/`Ctrl` `K`) and pick **Change Model** to switch the active model mid-conversation, or **Regenerate with Model…** to try the last answer on a different model.
You can also set a default in **Raycast Settings → AI → Commands → Quick AI → Default Model**.
##### Continue in AI Chat
When a question grows into something bigger, press `⌘`/`Ctrl` `J` to move the conversation into AI Chat. You keep the full history and get the chat workspace, longer context, and tools.
##### Auto-new Chat
Quick AI starts a fresh chat after a period of inactivity, so you don't accidentally tack new questions onto an older conversation. Adjust the timeout in **Raycast Settings → AI → General → Start New Chat** (options: 5 minutes, 10 minutes, 15 minutes, 30 minutes, 1 hour, always, never). This same inactivity timer also determines whether a Send to AI command reuses your active chat or starts a new one when AI Chat is closed.
##### Settings
Tune Quick AI from **Raycast Settings → AI → Commands → Quick AI**:
- **Quick AI Default Model**: default model used when opening Quick AI.
- **Primary Action**: paste to active app or copy the response to clipboard on `↵`.
- **Tab Shortcut**: hide the `Tab` hint in Root Search (the shortcut still works).
#### AI Chat
_(Only on Mac)_
AI Chat is Raycast's full chat workspace. Start a multi-turn conversation, attach context from your screen, give the model tools, and pick up where you left off across days.
**New** AI Chat is rebuilt in Raycast 2 with persistent history, Memory, rich attachments, and tool use, a full chat experience that replaces the single-shot AI flows in classic Raycast.
There are a few ways to start:
- Run the **AI Chat** command from Root Search to open the chat workspace.
- Press `⌘`/`Ctrl` `J` from a Quick AI conversation to continue it in AI Chat with the full history.
- Use a **Send to AI** command (Send Focused Window, Screen Area, Screen, or Selected Text) to send content into your active AI Chat from anywhere.
AI Chat lives in its own window, so you can keep it alongside whatever you're working on.
##### Start a Conversation
Type your prompt in the composer and press `↵` to send. `⇧` `↵` adds a new line. AI Chat streams the response back and remembers the whole thread, so each follow-up can build on earlier turns.
- Edit any previous message to re-run the conversation from that point.
- Regenerate the last response with `⌘`/`Ctrl` `R`.
- Start a fresh chat with `⌘`/`Ctrl` `N`.
- With an empty composer, `↑` / `↓` step through your recent messages.
When a response includes code, it appears in a code block with the detected language and a copy button. Long lines scroll sideways by default. Click **Enable line wrap** in the top right of the block to wrap them to the response width, and click again to switch back.
##### Switch Models
Open the model picker from the composer. Pick a fast model for chat, a reasoning model for harder problems, or an image-capable model when you want to generate visuals.
Tune model behavior from the settings sidebar:
- **Creativity**: None, Low, Medium, High, or Maximum.
- **Reasoning Effort**: for models that support extended thinking.
- **Web Search**: let the model pull live results during the answer.
##### Memory
Turn on Memory (in **Raycast Settings → AI → Personalization → Memory**) and AI Chat will remember durable facts across conversations: your name, the projects you work on, the format you prefer answers in. The model writes to and reads from memory automatically as you chat.
##### Attach Context
Hit the attach button in the composer or type `@` to add context to the next message. AI Chat can pull from:
- **Files**: documents, code, images.
- **Notes**: entries from Raycast Notes.
- **Clipboard History**: any recent clipboard item.
- **Focused Window**, **Window…**, **Selected Area**, or **Entire Screen**: screenshots from your desktop.
- **Browser Tabs**: open tabs from supported browsers.
- **Calendar Events**: today or upcoming.
- **Web Search**: live results during the answer.
Attachments are scoped to the message you send them with, but the model can keep referring back to them later in the chat.
When you use a Send to AI command from elsewhere in Raycast — **Send Focused Window to AI**, **Send Screen Area to AI**, **Send Screen to AI**, or **Send Selected Text to AI** — the content goes to your currently active chat instead of always starting a new one. If AI Chat is already open, it's sent straight to the active chat. If AI Chat is closed, your **Start new chat after inactivity** setting (see [Auto-new Chat](#auto-new-chat)) decides what happens: within the window the active chat is reused, and once it's elapsed a new chat begins. The one exception is streaming — if you close AI Chat while the active chat is still generating a response, that chat is always restored on next open, regardless of the timer.
##### Tool Use & Extensions
AI Chat can call tools: run a web search, generate an image, execute a terminal command, invoke an AI Extension, or hand work off to an MCP-compatible server. Toggle which tools are available per chat from the **Tools** section of the settings sidebar. With **Tool Confirmation** on, AI Chat asks before each tool runs.
##### Agents
Switch the chat to a saved Agent with the ** Change Agent** action in the Action Panel. Agents set instructions, model, and AI Extensions for consistent results until you switch agennts or choose **Ask Anything**. See the [Agents page](https://manual.raycast.com/ai/agents) page on creating your own.
##### Skills
Author reusable knowledge for the model with plain `SKILL.md` files. Raycast discovers them automatically and loads them when they're relevant to your chat. See the [Skills page](https://manual.raycast.com/ai/skills) for the full format and where to put them.
##### Manage Chats
The history sidebar shows every chat, with search at the top. From the Action Panel (`⌘`/`Ctrl` `K`) on any chat you can:
- **Pin** important conversations to the top.
- **Archive** chats you're done with. Old chats archive automatically after the window you pick in Settings (or never).
- **Delete** for good.
##### Always on Top
Toggle **Always on Top** from the Action Panel to keep AI Chat hovering over your other apps, handy while you're chatting about something on screen. You can also set this up in **Raycast Settings → AI → Commands → AI Chat → Always on Top**.
##### Continue from Quick AI
When a Quick AI question grows into something bigger, press `⌘`/`Ctrl` `J` to move it into AI Chat. The full history, model, and any attachments come with it.
##### Settings
Tune AI Chat from **Raycast Settings → AI**:
- **Start New Chat**: start a new chat after the specified timeout when opening Quick AI, and determines whether a Send to AI command reuses the active chat or starts a new one when AI Chat is closed.
- **Send Message**: keyboard shortcut used to send messages in AI Chat (`↵` or `⌘`/`Ctrl` `↵`).
- **Conversation History**: show conversations from AI Chat and Quick AI combined or keep them separate.
- **Auto-Archive Chats**: automatically archive chats after the specified period of inactivity.
- **Always on Top** (per-command, under AI Chat): keep the AI Chat window above other windows.
#### Troubleshooting
AI Chat and Quick AI let you talk to models from anywhere in Raycast. Most reports come down to the trigger key, model selection, sync, or hitting a usage or context limit. Here are the common ones.
##### Tab doesn't open Quick AI, or stops working
Quick AI opens by typing your question in the root search and pressing Tab. If Tab doesn't enter Quick AI, make sure you've typed a query first (Tab does nothing on an empty search), and check that no other Tab-completion behavior is taking priority. If it's intermittent, send us a screen recording so we can see the exact state of the search bar.
##### The model keeps resetting or picks the wrong one
Set your preferred model in **Raycast Settings → AI**. Quick AI and AI Chat can use different defaults, so set both. If the model still resets between sessions, note which command it resets in and send us your logs.
##### AI chats aren't syncing between devices
Cross-device sync for AI chats isn't available in the v2 Beta yet, so chats created on Mac v2 won't appear on iOS or other devices for now. This is expected during Beta, not a misconfiguration. If you're missing chats that previously synced from v1, let us know and include your Raycast version on each device.
##### Code or formatting comes out wrong (backslashes stripped, malformed blocks)
If code in a response drops backslashes or breaks formatting, copy it using the code block's copy action rather than selecting text by hand, which can pick up rendering artifacts. If the model itself is producing broken output, try a different model. Send us the prompt and a screen recording if it's reproducible.
##### The AI Chat window loses focus, won't float, or won't stay on top
Window behavior changed in v2. Check your AI Chat window preferences in **Raycast Settings → AI**. If the input box loses focus or the window drops behind other apps, note exactly what you did right before it happened, since these are usually tied to a specific action, and send us a screen recording.
##### I hit a request limit ("rate limit" / "too many requests")
Raycast AI has fair-usage request limits. During Beta, free access to GPT-5.4 mini on Mac v2 and Windows is capped at 50 requests per minute and 300 requests per hour. Raycast Pro and Advanced AI have access to different AI models. If you hit a limit, wait for the window to reset or upgrade your plan. Full breakdown: [Usage Limits](https://manual.raycast.com/ai/usage-limits)
##### I hit a context limit, or the chat says the conversation is too long
Each model has a fixed context window, and a long chat (or large attachments) can fill it, which trims earlier messages or blocks new ones. Start a fresh chat for a new topic, or switch to a model with a larger context window for long sessions. Context windows vary by model — you can compare them at [raycast.com/core-features/ai/models](https://www.raycast.com/core-features/ai/models) or in **Raycast Settings → AI → Models → Manage Models** (also available via the **Manage Models** command).
##### Still having issues?
Send us: a screen recording, whether it's AI Chat or Quick AI, the model you're using, whether it's reproducible across models, and your OS and Raycast version (**Settings → About**), plus your logs via the **Copy Raycast Logs** command.
For the screen recording, the quickest way is [ray.so/v2-record](https://ray.so/v2-record). Open the link in your browser, click record, capture what's happening, and share the resulting link in your report. No install needed.
### Dictation
Source: https://manual.raycast.com/ai/dictation
Description: Press, speak, and Raycast transcribes your words into clean, formatted text — pasted instantly wherever you're working.
Platforms: Mac, Windows, iOS
Tier: Free during Beta
Status: Updated
Last updated: 04 June 2026
Dictation turns speech into clean, formatted text anywhere you type. Trigger with a hotkey, speak naturally, and Raycast removes filler words, fixes punctuation, and pastes the result instantly. On iOS, the Raycast Keyboard brings the same experience to every text field.
#### Get Started
When you first open Dictation, you'll get started in three steps:
1. Grant Microphone access (macOS also requires the Accessibility permission for transcriptions to paste directly into your focused app).
2. Pick your input device. We recommend the built-in or wired microphone for the lowest latency.
3. Set your hotkey to trigger Dictation from anywhere without opening Raycast first
> [!TIP]
> On macOS, you can use Globe / `fn` key as your dictation hotkey. Open **System Settings → Keyboard → Press Globe / `fn` key to** and set it to **Do Nothing** so the system doesn't intercept the press first.
Press your hotkey to start a session. The **Dictation Pill** appears above your current app, showing a live waveform and timer. Speak naturally as Raycast handles filler words, punctuation, capitalisation, and grammar automatically.
Press your hotkey again to accept or `Esc` to cancel. Your text pastes into the active app, or copies to your clipboard, depending on your settings.
> [!TIP]
> Prefer hold-to-talk? Hold the hotkey down. Raycast switches to push-to-talk and when you release the hotkey, your session ends and recording finishes automatically.
> [!NOTE]
> Each dictation session is limited to **20 minutes** of dictation time. If you reach the limit, your session ends automatically and the transcription is processed.
#### Personalization
Personalization is where Dictation starts to feel like yours. Fine-tune every transcription with custom instructions, app-aware context, and a vocabulary built around the words and names that matter to you. You can personalize your experience in **Raycast Settings → Dictation → Personalization**.
##### Custom Instructions
_(Only on Mac)_
Add global guidance to shape how your words are transcribed. Use it to enforce things like spelling preferences, grammar rules, tone, name capitalisation, and formatting conventions. These instructions sit above any per-style settings and apply to every transcription.
##### App Context
_(Only on Mac)_
With App Context, Raycast reads the frontmost app, including its name, the field you're focused on, and any visible text nearby, then passes that to the transcription model to improve transcription accuracy.
> [!NOTE]
> App Context is used only for that transcription request and is never stored. Once the transcription is complete, the context data is discarded.
##### Vocabulary
Add words, names, brand terms, or jargon that Raycast should always get right. Entries are passed to the transcription model to improve accuracy when it hears something close to them.
#### Styles
_(Only on Mac)_
Styles shape your dictated text for different contexts. One spoken sentence becomes a tight Slack one-liner, a properly punctuated email, or any other format you define. You can control your transcription styling in **Raycast Settings → Dictation → Styles**.
##### Auto Styling
**Auto Styling** picks the right style for the app or website you're dictating into. **Email** style in Mail, **Messaging** style in Slack, or a custom "Code Comments" style in your editor. When **Auto Styling** is off, Raycast still applies baseline cleanup but you don't get app-aware formatting on top.
##### Custom Styles
Two styles come built in to Raycast. **Email** can format greetings, sign-offs, add paragraph breaks, and full punctuation. **Messaging** keeps transcriptions short, casual, and lightly punctuated for communication apps.
> [!TIP]
> You can adjust which apps and websites trigger each built-in style. If you use an app or website for email that isn't in our list, add it to the **Email** style to get the same formatting.
Create your own style using the ** Create Style** option in Raycast Settings, or use the **Create Style** command and give your style a **Name & Icon**, **Prompt**, and a list of **Apps & Websites** it should apply to.
A style prompt tells the AI how to clean up your transcript to match your expected output. Describe the artifact (meeting notes, agenda, PR review), the voice, and spell out mechanics (punctuation, capitalization, numerals, emojis).
#### Dictate to Note
Use the **Dictate to Note** command to skip dictating to the active app entirely and save the transcription as a new [Note](https://manual.raycast.com/notes). Useful for capturing ideas, voice memos, or meeting takeaways that you want to keep alongside your other notes without using another app or website.
#### Dictation History
Every transcription is saved to the **Dictation History** command so you can find and reuse it later. You can use the actions in the Action Panel to either **Paste**, **Copy to Clipboard**, **Delete Transcription** for the selected transcription, or **Delete All Local Transcriptions** to remove them all.
> [!TIP]
> Use the **Copy Last Transcription** command to quickly copy the last transcribed text without needing to open the **Dictation History** command.
#### Settings
All Dictation settings live under **Raycast Settings → Dictation**, including your preferred input device, general behavior options, and usage statistics.
##### Statistics
Over time, Dictation builds up a picture of your usage through statistics. You'll see your average WPM, estimated time saved, and total words dictated. Your stats are computed entirely on your device from your local transcription history. Statistics are not sent to Raycast as analytics nor telemetry.
##### Microphone
By default, Raycast uses your System Default microphone provided by the OS when **Use System Default** is turned on. You can customize your microphone priority list to switch between input devices throughout the day by turning **Use System Default** off.
Use **the drag handle** to reorder microphones by priority, or press **the ellipsis** to exclude a microphone from the list. Your currently active microphone appears in green at the top.
##### General
- **Language**: Select a specific dictation language, or leave on **Auto** to detect what you're speaking each time.
- **Output Action**: Paste the transcript directly into your active app (Default), or copy to your clipboard.
- **Sound Effects**: Play feedback when dictation starts or stops.
- **Mute While Recording**: Mute system audio while a session is active.
- **Finish and Cancel Shortcuts**: Choose the shortcut used to finish or cancel dictation.
> [!TIP]
> If you regularly dictate while using other apps and need `↵` to behave normally (for new lines, sending messages, etc.), turn **Allow Enter Hotkey** off and use your **Dictate** hotkey to accept transcriptions instead.
#### Privacy
Dictation is private by default. Your voice is never used to train AI models, audio isn't retained on Raycast servers, and your transcriptions and statistics are stored locally on your device. For full details on how your audio and transcriptions are handled, see [Raycast AI Privacy & Security](https://manual.raycast.com/ai/raycast-ai-privacy-security#dictation).
#### Dictate on iOS
_(Only on iOS)_
Dictation lives inside the [Raycast Keyboard](https://manual.raycast.com/ios/keyboard) and enables you to dictate from most text field in apps on your iPhone or iPad.
##### iOS Get Started
Install and enable the Raycast Keyboard before using Dictation. See [Keyboard](https://manual.raycast.com/ios/keyboard) for setup instructions.
1. In any app, tap a text field and switch to the Raycast Keyboard using the Globe icon.
2. Tap the waveform button button in selector on the Keyboard, then tap Waveform button to begin dictating. At the beginning of a dictation session, you will be redirected to the Raycast app – this is necessary since iOS keyboards don't have direct microphone access.
3. Speak naturally. Raycast handles filler words, punctuation, capitalisation, and grammar automatically.
4. Stop the recording with Stop Filled button or from the Live Activity. The cleaned-up text is inserted into your text field, or held for review, depending on your [**Insert Mode** setting](https://manual.raycast.com/ai/dictation#insert-mode).
> [!WARNING]
> As of iOS 26.4, Apple removed the ability for keyboards to detect the host app's bundle ID, so after dictating you'll need to swipe back to your previous app manually. We hope this is resolved in a future iOS update.
###### Dictation Session
After you start a dictation session, Raycast keeps a **5-minute session** alive in the background so you can dictate multiple times without recording to the app each time. While a session is active, you'll see a Live Activity. Tap it to control or end the session. You can also end it from the main app by tapping the power button.
Don't want a background session? Toggle **Disable Session** in **Raycast for iOS Settings > Dictation** to end it immediately, or after 5 minutes, 10 minutes, 15 minutes, 30 minutes, or 1 hour.
##### Insert Mode
By default, the dictation is inserted into your text field automatically. You can change the insertion mode by completing the following settings:
1. Open the Raycast app.
2. Tap your profile in the top right.
3. Tap **Keyboard** then change **Insert mode** to one of the following; Auto-insert, Review first, or Review on AI command.
##### Post-Processing
iOS Dictation includes the same concept as Styles, and allows you to run your dictation through a post-processing flow on top of the standard dictation cleanup to modify the output before inserted.
You can select the post-processing option under the Dictate button in the Raycast Keyboard, and choose from one of the following options:
- **Email**: Format your output for email
- **Notes**: Format your output for note-taking
- **Custom [AI Commands](https://manual.raycast.com/ai/ai-commands)**: Your own prompts, ideal for personal writing styles, translation, or specific tone adjustments
#### Troubleshooting
Dictation turns your speech into text anywhere on your system. Most issues come down to language detection, microphone selection, or the trigger key. Here are the common ones.
##### Dictation transcribes the wrong language
Dictation auto-detects the language you speak, and detection can slip between similar-sounding languages (for example Chinese being transcribed as Japanese or Korean).
To fix it, set your language explicitly in **Raycast Settings → Dictation → General** instead of relying on auto-detect. If you regularly switch languages, add the ones you use so the dictation post-processing task has a smaller set to choose from.
##### Words are consistently misheard
If Dictation keeps mistranscribing names, jargon, or technical terms, add them to Vocabulary under **Raycast Settings → Dictation → Personalization**. You can also use App Context and Custom Instructions in the same section to steer how transcriptions are formatted.
##### My microphone isn't listed (clamshell or external mic)
In clamshell mode (laptop closed with an external display), or with some external and Bluetooth mics, the device may not appear or get selected automatically.
Open the microphone picker in **Raycast Settings → Dictation → Microphone** and make sure the device isn't in your excluded list. If it's still missing, check the microphone is detected in **System Settings** on macOS and **Settings** on Windows.
##### There's a delay before dictation starts, or input lags
A few seconds of lag between pressing the trigger and Dictation responding is usually a hotkey or startup-cost issue. Try a simpler trigger key, make sure no other app is bound to the same shortcut, and check that your mic isn't being held by another app.
##### I want to trigger Dictation with a single key (F5, right Option, etc.)
You can bind Dictation to a single key in **Raycast Settings → Dictation → Commands**. If you're on macOS and pick an fn/Globe or function key (F1–F12) that doesn't register, disable "Use F1, F2, etc. keys as standard function keys" in **System Settings → Keyboard → Keyboard Shortcuts → Function Keys**. After that the key is captured correctly.
### AI Commands
Source: https://manual.raycast.com/ai/ai-commands
Description: AI Commands turn your favourite prompts into one press commands in Raycast. Rewrite, translate, summarise, or run any custom prompts in Raycast from any app.
Platforms: Mac, Windows, iOS
Tier: Free during Beta
Last updated: 28 May 2026
AI Commands turn prompts you reach for again and again into a one-press Raycast command. Pick text, open the command, get the result. Build your own to match how you write, code, or think, and chain in AI Extensions when a command needs to do more.
#### Discover AI Commands
##### Built-in AI Commands
Raycast ships a set of AI Commands that work out of the box. They're tuned for everyday cases like writing, communication, and code:
- **Improve Writing**: Tightens grammar and style without changing your meaning.
- **Fix Spelling and Grammar**: Corrects mistakes and highlights what changed.
- **Explain This in Simple Terms**: Simplifies a confusing word, sentence, or paragraph.
- **Change Tone to Professional**: Rewrites in a more formal register.
- **Change Tone to Friendly**: Warms up dry copy.
- **Find Bugs in Code**: Scans a snippet for likely issues.
- **Summarize Webpage**: Condenses the page open in your browser.
- **Ask About Webpage**: Answers a question about the page you're reading.
##### Quick Fix
**New** Quick Fix runs the **Fix Spelling and Grammar** AI Command directly in any focused app with one hotkey. Type into any field (or select some text), press the hotkey, and Raycast replaces the text in place.
The first time you run it, Raycast prompts you to grant the **Accessibility** permission on macOS so it can read and replace text in the active app. By default, Quick Fix is assigned to a double press of the right `Shift` key, so you can trigger it without leaving the keyboard.
The **Prefer Selection** option in **Raycast Settings → AI → Quick Fix** controls whether Quick Fix targets only the selected text (default) or the entire focused field.
##### Create AI Commands
To make your own, search the **Create AI Command** command in Root Search. You'll see a form with one required field and a handful of optional ones.
- **Prompt**: The instructions sent to the model. Type `@` to insert an AI Extension or `{` to insert a [Dynamic Placeholder](https://manual.raycast.com/dynamic-placeholders).
- **Name & Icon**: How the command appears in Root Search.
- **Model**: The model used when the command runs. AI Commands have their own model setting independent of Quick AI or AI Chat.
- **Creativity**: How loose the model's responses should be (none, low, medium, high, maximum).
- **Reasoning Effort**: For reasoning models, how much thinking the model should do before responding.
- **Highlight Editing Changes**: Useful for commands that rewrite selected text in-place. Raycast highlights what was edited.
- **Tags**: Free-form labels for organizing your commands.
- **Organization**: If you're in a Raycast team, choose whether the command is personal or shared with your org.
Press `⌘`/`Ctrl` `Enter` to save. The command appears in Root Search immediately.
> [!TIP]
> Built-in commands can be the starting point for your own. Find one in **Search AI Commands**, press `⌘`/`Ctrl` `D` to duplicate, then tweak the prompt, model, and creativity to match how you actually work.
#### Using AI Commands
Run an AI Command from Root Search like any other command. Most commands work on the active app's selection or focused field, so you typically:
1. Select some text in any app.
2. Open Raycast.
3. Search for the command and hit `Enter`.
Raycast shows the response in a window, and from there you can copy it, paste it, or continue the conversation with Raycast AI to refine or discuss the output.
A few prompt patterns to get you started:
- `Translate {selection} to Swedish`: Translate whatever you've highlighted.
- `Summarize {selection} into three bullet points`: Quick TL;DR.
- `Reply to this email in my tone: {selection}`: Drafted replies on tap.
- `{argument name="Language"}`: When you want to type a value at runtime, use an argument placeholder. Raycast prompts you for **Language** before the command runs.
`{selection}` and `{argument}` are two of many [Dynamic Placeholders](https://manual.raycast.com/dynamic-placeholders) you can drop into a prompt. Others pull in your clipboard, the current date, the focused app, and more.
You can also pull in AI Extensions to make commands act on your tools, not just text. A command with `@calendar what does my afternoon look like?` becomes a one-shot daily check-in.
#### Manage AI Commands
Search **Search AI Commands** in Raycast to see every command you've created or that's built in. From the action panel:
- **Edit AI Command** (`⌘`/`Ctrl` `E`): Open the command in the form view to change any field.
- **Duplicate AI Command** (`⌘`/`Ctrl` `D`): Copy a command. The fastest way to start from a built-in.
- **Share AI Command**: Generate a shareable link for a command so a teammate can install it with one click.
- **Import AI Commands**: Bring in a set of commands from a JSON file. Use **Import AI Commands** in Root Search.
Built-in commands can be edited and duplicated but not deleted; your custom commands can be removed from the same action panel. Tags make it easier to keep a large library organized. Assign them when creating or editing, and filter by them in **Search AI Commands**.
### AI Extensions
Source: https://manual.raycast.com/ai/ai-extensions
Description: AI Extensions empower Raycast AI to perform actions and automate workflows within your extensions, allowing you to accomplish more simply by asking.
Platforms: Mac
Tier: Free during Beta
Last updated: 04 June 2026
AI Extensions are how you let Raycast AI take action across your installed extensions. Once an extension exposes its commands as tools, you can mention it from AI Chat, Quick AI, or Root Search and the AI figures out which tool to call, with what arguments, and runs it for you.
[AI Extensions in Raycast (YouTube)](https://www.youtube.com/watch?v=sHIlFKKaq0A)
#### Discover AI Extensions
##### Built-in AI Extensions
Raycast includes several built-in AI Extensions that can be used to interact with Raycast itself or other apps on your Mac:
- **Browser**: `@browser` reads and reasons about the page open in your browser.
- **Calendar**: `@calendar` asks about your schedule, free slots, or upcoming events.
- **Clipboard**: `@clipboard` pulls the AI into your clipboard history.
- **Finder**: `@finder` searches files and folders on your Mac.
- **Focus**: `@focus` controls Focus sessions and asks what you're scheduled for.
- **Location**: `@location` knows where you are when you ask "what's nearby?".
- **Selected Text**: `@selected-text` pulls in whatever you've highlighted in another app.
- **Terminal**: `@terminal` runs and reasons about shell commands.
- **Weather**: `@weather` answers without a separate trip to a weather app.
##### Install AI Extensions
More AI Extensions are available on the Raycast Store. Open the Store from Root Search and filter by the **AI Extensions** category in the Navigation Bar (`⌘` `P`) to see only the extensions that ship with tools attached. These cover everything from project trackers and music players to image editors and home automation.
#### Using AI Extensions
Type `@` in AI Chat, Quick AI, or Root Search and a list of every installed AI Extension appears. Pick one and chat in natural language. The AI chooses the right tool and shows you the call as it happens. Example prompts:
- `@linear what's assigned to me this sprint?`
- `@calendar block out 2 hours tomorrow morning for deep work`
- `@github pull requests waiting on my review`
- `@spotify play something mellow but not sad`
You can also chain them in a single prompt: `@calendar @things any free slots tomorrow that I could use to clear overdue tasks?` and the AI will read both before answering your request.
##### Permissions
By default, Raycast asks for approval before running any tool from an AI Extension. You can change the default option in **Raycast Settings → AI → Permissions**, or override it for a single chat from the AI Chat's Chat Settings menu.
#### Manage AI Extensions
Each installed extension has its own section in **Raycast Settings**. Select one and you'll see the list of individual commands and the **Ask** tool it exposes. The **Ask** tool includes a free-text **Custom Instructions** field. Use it to steer the extension's behavior, for example "default my Linear queries to the Platform team" or "never schedule meetings before 10am." The AI reads these instructions whenever it considers using that extension's tools.
To remove an AI Extension entirely, uninstall the underlying extension from the Store; its tools disappear from `@-mentions` immediately.
### Agents
Source: https://manual.raycast.com/ai/agents
Description: Agents are saved AI setups — a name, instructions, a model, and a set of tools — that you switch into for recurring questions and tasks, so Raycast AI responds the way you want for that kind of work.
Platforms: Mac
Last updated: 04 June 2026
Agents are for the questions and tasks you handle over and over, tailored to your way of working. Instead of configuring from scratch each time, you save the role, model, and tools as an Agent and pick it when you need it. An Agent follows it the whole chat, so you get consistent results for a particular kind of work.
> [!NOTE]
> Agents were previously called **Presets** in Raycast v1. They're functionally the same — only renamed.
#### Get Started
To build your first Agent:
1. Open **Raycast Settings → AI → Agents**.
2. Click **Plus iconCreate New Agent**.
3. Personalize your agent with the following:
- **Name & Icon**: Give the Agent a clear name and pick an icon.
- **Model**: Choose the model the Agent should use, or use **Inherit** to use the Chat's selected model. If you set a model, it's locked for any chat using that Agent.
- **Instructions**: Write the system prompt that defines the Agent's role and rules. Lead with the role and the rules it should always follow.
- **AI Extensions**: Add the AI Extensions this Agent is allowed to call. Only the extensions you add here are available to it, which scopes the Agent to just the AI Extensions its task needs.
- **Advanced**: When the selected model supports it, set **Reasoning Effort**.
4. Click **Save Agent** `⌘` `↵`.
Your new Agent is immediately available in AI Chat's **Change Agent** action and in the **Search Agents** command. To use it, open **AI Chat**, open the Action Panel `⌘` `K`, choose **Change Agent**, and pick it.
#### Built-in Agents
Raycast includes a ready-made **Deep Research** Agent — tuned for thorough, source-backed answers — so you can see how Agents work without building one first.
Built-in Agents can't be edited or deleted, but you can use the ** Disable** option to hide it.
> [!TIP]
> Looking for more Agents? Browse a community library of ready-made Agents on the [Preset Explorer](https://ray.so/presets) and add any of them to Raycast in one click.
#### Use an Agent in Chat
There are two ways to switch Agent inside **AI Chat**:
- **Action Panel**: Open the Action Panel `⌘` `K` and choose **Change Agent**, then pick any Agent — or pick **Ask Anything** to remove it.
- **Slash menu**: Type `/` in the composer to open a quick switcher, then pick an Agent from **Custom Agents** or **Built-in Agents**. Choose **Default** to clear the current Agent.
> [!NOTE]
> When an Agent has a model assigned, the chat's model picker is locked to that model — the Agent decides which model is used. Agents using models set to **Inherit** allow you to switch models in the chat as usual.
You can also start a new conversation already set to an Agent with the **New Chat with Agent** action, available both in the Agents settings and from the **Search Agents** command.
#### Search Agents from Root Search
Agents are also visible Root Search and through the **Search Agents** command. Open the command to browse your Agents (grouped into **Custom Agents** and **Built-in Agents**), search by name, and use specific actions in the Action Panel:
- **New Chat with Agent**: Press `↵` to open AI Chat with that Agent active.
- **Create Agent**: Go straight to the new Agent dialog in Raycast Settings.
- **Edit Agent** / **Duplicate Agent**: Open the Agent dialog to change a custom Agent, or clone any Agent as a new one.
- **Configure Agent**: Assign a **hotkey** or **alias** so you can launch the Agent directly from Root Search.
- **Hide/Show in Root Search**: Control whether an Agent appears as its own item in root search.
- **Delete Agent** / **Delete All Agents**: Remove a single custom Agent or all of them.
> [!TIP]
> Because each Agent is its own Root Search item, you can give a frequently used Agent a hotkey and jump straight into a new AI Chat with it without opening it first.
#### Settings
All Agent settings can be found in **Raycast Settings → AI → Agents**. Your Agents are split into built-in and custom groups. For a custom Agent you can:
- ** Edit**: Click the Agent's name to open the edit dialog.
- ** Enable / Disable**: toggle whether it shows up in the Agent menus.
- ** Delete**: remove it (you'll be asked to confirm; this can't be undone).
Built-in Agents show in their own group and can be ** Disabled** but not edited or deleted.
#### Agents, Extensions & Skills
Agents tie together several Raycast AI building blocks:
- **AI Extensions**: An Agent's tool list scopes which [AI Extensions](https://manual.raycast.com/ai/ai-extensions) it loads by default, so you can keep it focused on the tools its task needs.
- **Skills**: [Skills](https://manual.raycast.com/ai/skills) are still discovered automatically based on your message; you don't attach them to an Agent. An Agent's instructions and a relevant Skill can apply in the same conversation.
- **AI Commands**: [AI Commands](https://manual.raycast.com/ai/ai-commands) are separate, single-shot prompts. Agents are for ongoing conversations where the role, model, and tools should persist.
### Skills
Source: https://manual.raycast.com/ai/skills
Description: Skills extend Raycast AI with reusable knowledge and instructions that models can use automatically when it's relevant to your chat.
Platforms: Mac
Last updated: 04 June 2026
Skills are reusable context for Raycast AI. Instead of pasting the same conventions, guidelines, or domain knowledge into every prompt, you write them once as a plain `SKILL.md` file, drop it into a folder, and Raycast handles discovery automatically. It scans your library and loads whichever skills are relevant to your Chat prompts.
#### What is a Skill?
A skill is a small, focused unit of context (instructions, examples, conventions, or domain knowledge) that Raycast AI can load on demand. Think of it as a piece of expertise the model can reach for when the conversation calls for it, rather than something you have to remember to attach every time.
Skills are stored as files in default folders used by common AI agents, or you can add your own directories. Each skill describes when it should be used and what knowledge or steps it brings to the conversation, so Raycast can decide on its own whether to load it for a given message.
> [!TIP]
> You can create your own skills to use inside Raycast, as well as across other AI platforms. Learn more about the open standard on [Agent Skills](https://agentskills.io/home).
#### Discover Skills Automatically
By default, Raycast AI looks at the message you're sending and pulls in any skills from your configured directories that look relevant, so you don't need to attach them by hand. This keeps the Chat input clean and lets your skill library scale without adding friction.
Toggle this behavior per chat in AI Chat from **Chat Settings → Skills → Discover Skills Automatically**. Turning it off fully excludes skills from that conversation; they aren't added to the model's context and there's currently no way to mention a skill manually.
> [!NOTE]
> The **Discover Skills Automatically** toggle is per-chat in AI Chat and can be changed at any time. Quick AI has skill discovery turned on for all chats.
#### How Loading Works
When you send a message in AI Chat or Quick AI, Raycast shows the model a compact catalog of every skill it found, including the `name`, `description`, and file path from each frontmatter, not the body. If the model decides one or more skills look relevant, it loads them through a tool call and reads their full Markdown content before answering.
- **A clear `description` matters most.** It's the only signal the model has when deciding what to load. Lead with *when* to use the skill ("Use when adding a new screen to the admin panel…") rather than what's inside it.
- **Skills only run on models that support tools.** If you've picked a model without tool support, skills won't be offered. Most modern models qualify, but it's worth checking when something seems missing.
- **AI Commands don't use skills.** Commands are intentionally narrow and predictable, so Raycast keeps the skill catalog out of them.
#### Settings
All your skills appear in **Raycast Settings → AI → Skills**. The page lists every skill Raycast has found, with its description, so you can scan your library at a glance.
Raycast watches your skill folders for changes. Adding, editing, or removing a skill file updates the list within a minute. By default, Raycast scans the following folders:
By default, Raycast scans a set of folders for skills available on your Mac. You can add other skill folders by clicking the Plus button on Skill Folders.
- `~/.claude/skills`
- `~/.config/agents/skills`
- `~/.config/raycast/skills`
- `~/.agents/skills`
Each skill must reside in its own subfolder, with the folder name matching the `name` in the frontmatter, and the file itself must be named `SKILL.md` exactly (case-sensitive). Other `.md` files in the folder are ignored. Raycast scans only the top level of each specified folder and does not search recursively for skills.
#### Skills vs. AI Extensions
Skills and AI Extensions both let Raycast AI go beyond the model's built-in knowledge, but they solve different problems:
- **[AI Extensions](https://manual.raycast.com/ai/ai-extensions)** give the model *tools*: actions it can take, like searching your notes, querying an API, or running a command.
- **Skills** give the model *context*: instructions, conventions, and knowledge it should apply when working on a particular kind of task.
The two pair naturally: an AI Extension to fetch the data, a Skill to tell Raycast how you want it interpreted or written up.
**[Agents](https://manual.raycast.com/ai/agents)** build on both: an Agent carries its own instructions and a scoped set of AI Extensions, while Skills still load automatically alongside whichever Agent is active.
#### If a Skill Isn't Loading
When a skill fails to load, Raycast skips it silently and continues with your chat. If a skill you expect isn't showing up, check the following:
- It's in one of the default folders, or in a custom folder you added in **Settings → AI → Skills**.
- It lives in its own subfolder, and the folder name matches `name` in the frontmatter exactly.
- The file is named `SKILL.md` (case-sensitive) and starts with valid YAML containing both `name` and `description`.
- The `name` follows the rules: 1–64 characters, lowercase letters, digits, and hyphens, with no consecutive or trailing hyphens.
- The `description` is between 1 and 1024 characters.
- You're testing in AI Chat or Quick AI on a model that supports tools. Skills don't run in AI Commands.
- **Discover Skills Automatically** is on for the AI Chat you're wanting to use the skill in.
- Give it a minute. The folder scan is cached for about 60 seconds, so a fresh skill can take that long to appear.
If two skills share the same `name`, Raycast keeps the first one it finds and ignores the rest, so rename one of them if you're expecting both to coexist.
### Personalization
Source: https://manual.raycast.com/ai/personalization
Description: AI Personalization blends a Profile you define with an intelligent Memory crafted from your interactions, enabling Raycast AI to deliver responses that are uniquely relevant and tailored to you.
Platforms: Mac, Windows
Tier: Free during Beta
Last updated: 07 May 2026
Raycast AI learns about you over time to provide more relevant, personalized responses. This page explains how AI Personalization works, what data is involved, and how you stay in control.
#### What is AI Personalization?
AI Personalization consists of two parts, found in **Raycast Settings → AI → Personalization**:
##### Profile
Text you write yourself to give AI context about you: for example, your role, preferred coding language, or communication style. Your Profile is entirely manual and only contains what you choose to share.
##### Memory
A summary that Raycast AI automatically builds from your conversations over time. It captures relevant context like your projects, preferences, and goals to make future interactions more helpful.
#### How Memory Works
Every few hours, Raycast collects your recent AI Chat and Quick AI conversations and sends them (along with your current memory) to the AI model. The model distils this into an updated memory summary. This uses the same infrastructure, providers, and privacy protections as sending a message in AI Chat.
> [!NOTE]
> Memory in Raycast AI is stored locally on your device, synced via Cloud Sync when enabled (encrypted, like all other synced data), and never used to train AI models.
#### What Raycast Remembers
Memory focuses on context that helps improve your AI interactions:
- Your role and professional context
- Projects you're working on
- Technical preferences and tools you use
- Communication style and preferences
#### What Data Is Sent?
Only your chat contents are used to build Memory. No additional personal information (name, email, etc.) is sent beyond what's already part of your conversations. The same agreements with AI providers that prevent your data from being retained and used for model training apply here.
#### Managing Your Personalization
You have full control over your AI Personalization:
- **View and edit your Memory**: See exactly what Raycast remembers in **Raycast Settings → AI → Personalization**. You can edit or clear your memory at any time.
- **Add to Memory manually**: Select text in a conversation and use **Add to Memory** (`⌘`/`Ctrl``⇧`/`Shift``L`) to save specific information.
- **Ask AI to remember**: Tell AI to "remember this" or "update my memory" directly in a chat.
- **Disable Memory**: You can turn off Memory entirely in **Raycast Settings → AI → Personalization**.
#### Privacy and Security
- AI Personalization follows the same privacy and security standards as all Raycast AI features
- Your conversations are not recorded or logged: Memory is a distilled summary, not a transcript
- AI providers cannot use your data for model training (see our [AI](https://www.raycast.com/core-features/ai) and [AI Privacy + Security](https://manual.raycast.com/ai/raycast-ai-privacy-security) page)
- Memory synced via Cloud Sync is encrypted at rest and in transit
- For full details, see our [Terms of Service](https://www.raycast.com/terms-of-service), [Privacy Policy](https://www.raycast.com/privacy) and [AI Privacy + Security](https://manual.raycast.com/ai/raycast-ai-privacy-security) page
#### FAQ
##### Is AI Personalization available on all platforms?
AI Personalization (Profile and Memory) is available on macOS and Windows. Your memory syncs across devices when Cloud Sync is enabled.
##### Does Memory store my full conversations?
No. Memory is a distilled summary of relevant context, not a transcript. Your conversations are not recorded or logged.
### Usage Limits
Source: https://manual.raycast.com/ai/usage-limits
Description: Discover how Raycast AI usage is counted and explore the request limits for Free, Pro, and Advanced AI plans across Mac, Windows, and iOS.
Tier: More with Pro
Last updated: 01 June 2026
Raycast AI puts powerful models from Anthropic, OpenAI, Google, and more right at your fingertips. All AI usage through Raycast AI is subject to fair usage limits designed to keep the service fast, reliable, and available for everyone.
> [!NOTE]
> Want more powerful AI models and unlimited messages? Upgrade to [Raycast Pro](https://raycast.com/pro), available with a 14-day free trial. Add Advanced AI at any time for leading frontier models and higher request limits.
#### Free Request Limits
##### Mac v2 and Windows
All Raycast users on Mac v2 and Windows receive free access to GPT-5.4 mini during Beta, subject to our standard usage limits. This means you can start using Raycast AI at no cost.
- 50 requests per minute
- 300 requests per hour
##### iOS and Mac v1
Free users on Raycast for Mac v1 and on iOS receive 50 free messages to try Raycast AI with any of the [models available in Raycast Pro](https://www.raycast.com/core-features/ai/models). Each message you send counts as one request. After these free messages are used, you can upgrade to a [Raycast Pro](https://raycast.com/pro) plan, which includes a 14-day free trial.
#### Pro Request Limits
These limits are shared across all models within their group. As AI is a fast-moving space, we review our limits regularly and reserve the right to update these request limits at any time.
##### Raycast Pro Models
Raycast Pro gives you unlimited messages to dozens of AI models from several AI providers, including frontier models.
- 50 requests per minute
- 300 requests per hour
**Exceptions** – 150 requests per 24 hours:
- **OpenAI** — o3-mini, o4-mini
##### Advanced AI Models
In addition to AI models and limits available in Raycast Pro, Advanced AI is a subscription add-on that provides higher request limits and leading frontier models.
- 75 requests per 3 hours
- 150 requests per 24 hours
**Exceptions** – 50 requests per week per model:
- **OpenAI** — o1, GPT-5.5, GPT-5.5 Instant
- **Anthropic** — Claude Opus 4.6, 4.7, 4.8
#### Additional Information
- Context windows vary by model. You can compare them at [raycast.com/core-features/ai/models](https://www.raycast.com/core-features/ai/models) or in **Raycast Settings → AI → Models → Manage Models** (also available via the **Manage Models** command).
- The **Submit Without Generating** action in Raycast v1's AI Chat does not count towards your request limits.
- If you are using Raycast AI and provided your own API key using Bring Your Own Key, the request limits mentioned above do not apply.
### Bring Your Own Keys
Source: https://manual.raycast.com/ai/bring-your-own-keys
Description: Connect your own API key from Anthropic, Google, or OpenAI to use Raycast's AI features without a Pro subscription.
Platforms: Mac, Windows, iOS
Last updated: 04 June 2026
Bring Your Own Key (BYOK) lets you connect your own API key from Anthropic, Google, or OpenAI to use with Raycast's AI features without a Pro subscription. You'll be responsible for the API costs incurred at the provider's standard rates. Only [AI models available in Raycast AI](https://www.raycast.com/core-features/ai/models) will be available as models through BYOK.
You can add one API key per provider from [Anthropic](https://console.anthropic.com/settings/keys), [Google](https://aistudio.google.com/apikey), and [OpenAI](https://platform.openai.com/api-keys). BYOK on iOS also supports [OpenRouter](https://openrouter.ai/). Be sure to monitor the provider's API console to prevent costly surprises when using your own key.
> [!NOTE]
> If using BYOK, requests are processed through our servers in order to unify the model APIs, integrate fallback behaviors, and do some final prompt management. Learn more about BYOK and Privacy on the [Raycast AI Privacy & Security](https://manual.raycast.com/ai/raycast-ai-privacy-security) page.
#### Add a Key
**Desktop**
1. Open **Settings → AI**.
2. In the API Keys section, click **Plus icon** to add your key.
3. Select your provider from the dropdown.
4. Paste your key into the API Key field, then click **Verify**. Raycast will check the key with the provider to ensure it can be used.
5. Once verified, click **Save**. The key is stored securely and the provider appears in your API Key list.
If you don't yet have a key, the **Manage in [Provider] Console** button opens the provider's key console page in your browser.
**iOS**
1. In the top right, tap your **Account Avatar -> AI -> Custom API Keys**.
2. Select your provider from the list.
3. Paste your key into the API Key field, then tap ** Verify**. Raycast will check the key with the provider to ensure it can be used.
4. Once verified, tap **the back icon** to save.
If you don't yet have a key, the **Manage in [Provider] Console** button opens the provider's key console page in the browser.
#### Managing & Deleting Keys
**Desktop**
Each configured provider entry in the API Keys list will show:
- A **toggle** to enable or disable the key without deleting it. Disabled keys won't be used for any AI request.
- **Trash button** Remove the key entirely.
- **NE Arrow button** Shortcut to the provider's console for rotating or revoking the key on their side.
When an API key is active, a small key icon appears next to that provider's model names in Raycast AI to show that the request will use your provided API key.
**iOS**
**Custom API Keys** will show all available providers you can use.
- **Key icon** Shows next to providers you have connected an API key with.
- Tap any active providers and tap ** Remove** to delete the API key.
When an API key is active, a small key icon appears next to that provider's model names in the AI Chat model picker to show that the request will use your provided API key.
#### FAQ
##### My key fails to verify when adding to Raycast
Double-check the key is pasted in full with no surrounding whitespace, and confirm it's active in the provider's console. If you've just created the key, give the provider a moment to propagate it on their end.
##### I can't see a model I want to use with BYOK in the model picker
Raycast is responsible for the list of AI models available for AI features inside the app. If a brand-new model isn't showing, we may still be working on adding it on our side. The [Raycast AI Models](https://www.raycast.com/core-features/ai/models) page lists all models available from each provider in Raycast AI.
##### My requests are using Raycast AI even though I've added my own key
Make sure the key has been enabled in API Keys under **Raycast Settings → AI** on desktop or **Account Avatar -> AI -> Custom API Keys** on iOS, then re-pick the model where you wish to use it in Raycast.
##### I want to stop using BYOK in Raycast
You can either toggle the API key off in **Raycast Settings → AI** to keep the key available for later, or click the **Trash button** icon to remove it entirely. On iOS, you can only remove the key in the **Custom API Keys** settings.
### Model Context Protocol
Source: https://manual.raycast.com/ai/model-context-protocol
Description: Connect Model Context Protocol (MCP) servers to Raycast AI to extend Chat with custom tools, data sources, and integrations from across your stack.
Platforms: Mac
Last updated: 04 June 2026
Model Context Protocol (MCP) is how you plug external tools and data sources into Raycast AI. Once a server is connected, its tools become available to AI Chat, Quick AI, and AI Commands alongside everything Raycast already knows about you and your installed extensions.
#### Install MCP Servers
To add a new MCP server, search for the **Install MCP Server** command or use the **Install New Server** action in the **Manage MCP Servers** command then fill out the form. Give the server a name & icon, select the transport & connection details, optionally a description.
Press **Install MCP Server** `Cmd` `Enter` and Raycast saves the config, starts the connection, and pulls in the tool list automatically. Stdio servers run as soon as they're installed; HTTP servers with OAuth will prompt you to **Sign In** before any tools become available.
> [!TIP]
> If a stdio command relies on something on your `PATH`, restart Raycast after editing your shell environment so the new values are picked up.
##### Configuration Fields
- **Name & Icon**: how the server appears in lists, mentions, and the action panel.
- **Transport**: *Standard Input/Output* or *HTTP*.
- **Command** *(stdio)*: the executable to run, e.g. `npx` or a path to a binary.
- **Arguments** *(stdio)*: passed to the command. Accepts a space‑separated string or a JSON array.
- **Environment** *(stdio)*: key/value pairs injected into the server's environment, e.g. API tokens.
- **URL** *(HTTP)*: the server's MCP endpoint.
- **HTTP Headers** *(HTTP)*: key/value pairs sent on every request.
- **OAuth Type** *(HTTP)*: *Dynamic* if the server supports OAuth Dynamic Client Registration, *Static* if you need to provide your own credentials.
- **Client ID / Client Secret / Scopes** *(HTTP, Static OAuth only)*: pre‑registered OAuth credentials and the scopes to request.
- **Description**: optional shown in the details pane.
##### Transports
Raycast supports two ways of talking to an MCP server:
- **Standard Input/Output**: a local process that Raycast launches and pipes JSON‑RPC over stdin/stdout. Good for anything you'd run from the terminal: `npx`, a Python script, a compiled binary.
- **HTTP**: a remote endpoint that speaks MCP over HTTP (including the Streamable HTTP variant). Good for hosted services.
##### Authentication
For HTTP servers that require OAuth, Raycast handles the full flow. Dynamic OAuth uses Dynamic Client Registration with PKCE: click **Sign In** and Raycast registers itself as a client. Static OAuth uses a Client ID (and optional Secret) you provide, which services like Slack require. Tokens are stored encrypted, per server.
To start fresh, the **Logout Server** in the **Manage MCP Servers** action clears saved tokens for an HTTP server without removing it.
#### Manage MCP Servers
Search **Manage MCP Servers** in Raycast to see every installed server with its status, tool list, and details in one place. Each server is either **Running** (connected and serving tools), **Stopped** (installed but not connected), or in an **Error** state. The details pane shows the full output from the server or transport.
From this command, you can start a new chat with the selected server or open the Action Panel for more options: Add Server, Refresh, Start, Stop, Restart, Logout, and Uninstall.
#### Using MCP Servers
Every server gets a `@-mention` name like AI Extensions. In AI Chat or Quick AI, type `@` and enter the server's name to scope a question to it. Type `@linear what's assigned to me?` to ask the Linear MCP server directly. Raycast also adds an **Ask** command for each installed server to Root Search (e.g. **Ask Linear**), prefilling Quick AI with that mention.
##### Permissions
By default, Raycast asks for approval before running any tool from an MCP server. You can change the default option in **Raycast Settings → AI → Permissions**, or override it for a single chat from the AI Chat's Chat Settings menu.
### Raycast AI Privacy & Security
Source: https://manual.raycast.com/ai/raycast-ai-privacy-security
Description: Discover how Raycast AI keeps your data private, safe, and secure. Learn about our strict privacy policies, zero background data collection, no prompt training, encrypted AI processing, opt-in feedback, and full user control.
Last updated: 04 June 2026
At Raycast, we prioritize your privacy and security in all our AI features. With this document, we aim to provide clarity and transparency about how AI works in Raycast and our commitment to privacy and security.
- [Terms of Service](https://www.raycast.com/terms-of-service)
- [Privacy Policy](https://www.raycast.com/privacy)
#### Key Principles
You should know when and how AI is used and activated in Raycast. You should always be in control of your interaction with AI and have the ability to opt-out at any time. We will be transparent and open about how your data and AI inputs/outputs are used. We believe consent is crucial and aim to provide the best, most transparent AI user experience.
#### How Raycast AI Works
Raycast AI only runs when you explicitly trigger it; meaning, you ask AI a question, run an AI command, or otherwise interact with AI directly. The only time AI may activate without explicitly being called is with Emoji Search - which is opt-in and requires your consent.
Raycast AI does not run in the background or monitor your activity. Your data is not used to train AI models. If you choose to send feedback, your data may be used to improve our AI system; this is strictly opt-in and you will be prompted to consent before data is sent.
#### About Raycast AI
##### Data Collection & Usage
- Your AI interactions are not recorded
- We do not collect or store sensitive information
- We do not log or retain any user prompts. We do store some basic metadata, such as the number of completion tokens, for operational purposes only.
- Cloud Sync: when enabled, the client sends content such as Snippets, AI Chats, etc. to our backend. We store this information encrypted in our databases.
- AI attachments: Image attachments are securely uploaded to our servers for AI processing, enabling you to access them later. If you delete a message or chat that includes attachments, those attachments will be deleted from the server.
- AI Feedback: If you choose to report feedback, the full chat thread — including AI Extension tool calls and results — will be sent to us. This is **entirely opt-in** and you must give explicit consent before any data is sent. **Please be mindful of any sensitive data the thread might contain**. We may use this information to improve the reliability of our AI System.
##### AI Personalization & Memory
When enabled, Raycast AI can build a memory summary from your conversations to personalize future responses. Memory is stored locally and encrypted at rest and in transit when synced via Cloud Sync. It follows the same privacy and security standards as all AI features. Your data is never used to train models. You can view, edit, or delete your memory at any time. You can learn more on the [Personalization](https://manual.raycast.com/ai/personalization) page.
##### Dictation
[Dictation](https://manual.raycast.com/ai/dictation) is designed to be private by default. Your voice is never used to train AI models, and we don't store your audio or transcriptions on our servers.
- Your audio is sent to our speech‑to‑text partner solely to produce a transcription, and isn't retained on Raycast servers after the request completes. Our partners are contractually prohibited from using it to train their models.
- Every transcription is saved to your local app's database on your device, not in our cloud, so you can find and reuse it later. You can delete individual transcriptions or wipe the entire history at any time in the **Dictation History** command.
- Your dictation statistics are computed on‑device from your local history and are never sent to Raycast as analytics or telemetry.
- If App Context is enabled, nearby text and app details are used only for that single transcription request and discarded as soon as the transcription is complete. Nothing is stored.
#### AI Processing & Partners
- Our AI features are powered by leading providers including OpenAI, Anthropic, Perplexity, and more (see the complete list of [AI providers we use and their Terms below](#ai-providers-terms))
- All AI processing occurs through secure server infrastructure to ensure the safety of our API keys
- BYOK (Bring Your Own Key):
- Anthropic, Google, OpenAI: Requests are processed through our servers in order to unify the model APIs, integrate fallback behaviors, and do some final prompt management. This helps to maintain the quality and consistency of output when using your own API key vs. ours.
- OpenRouter: Requests are routed directly from your device to OpenRouter's servers.
- Custom API keys are stored locally on the user’s computer, not in our backend
- When using BYOK, you maintain the contractual relationship with the AI provider. Please consult their privacy policies and terms for more details.
- When using Raycast AI (not BYOK), [our agreements with providers](https://www.raycast.com/terms-of-service#viii-generative-ai) prohibit them from using any AI interactions to train their models. When you use our AI features, we:
- Forward your input to the AI provider's API
- Exclude any personal information when doing so
- Only share the minimum necessary data
- AI input and output is encrypted during transmission
#### User Control & Transparency
- AI features are optional and user-controlled. Users can completely disable AI.
- Before using Raycast AI, you will be prompted to read and accept our Terms of Service if you haven’t accepted them in the past. AI does not run in the background and you must actively consent before AI can be activated.
#### AI Providers Terms
| Provider | Terms of Service |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| OpenAI | [Terms of Use](https://openai.com/policies/terms-of-use), [Usage Policies](https://openai.com/policies/usage-policies) |
| Anthropic | [Commercial Terms](https://www.anthropic.com/legal/commercial-terms) |
| Perplexity | [API Terms of Service](https://www.perplexity.ai/hub/legal/perplexity-api-terms-of-service) |
| Groq | [Terms of Use](https://groq.com/terms-of-use) |
| Together AI | [Terms of Service](https://www.together.ai/terms-of-service) |
| Mistral AI | [Terms](https://legal.mistral.ai/terms) |
| Google Gemini | [Gemini API Terms](https://ai.google.dev/gemini-api/terms) |
| xAI | [Terms of Service (Enterprise)](https://x.ai/legal/terms-of-service-enterprise) |
| Replicate | [Terms](https://replicate.com/terms) |
#### Open Source Extensions
As a company that believes in the value and importance of open source software, Raycast has a rich and expansive extension ecosystem. Note that third-party extensions may use their own logic for AI. As all extensions are [open source](https://github.com/raycast/extensions), you can refer to an extensions’ README or source code for further information.
---
We continuously review and update our privacy practices to maintain the highest standards of data protection while delivering powerful AI capabilities. If you have questions or suggestions, you can contact us via [privacy@raycast.com](mailto:privacy@raycast.com).
## iOS
### iOS
Source: https://manual.raycast.com/ios
Description: Raycast for iOS brings AI, Dictation, Notes, Snippets, and Quicklinks to iPhone and iPad with deep integrations across iOS widgets, Shortcuts, and the keyboard.
Last updated: 11 May 2026
Your productivity powerhouse, now in your pocket. Raycast for iOS brings Raycast AI, Dictation, Notes, Snippets, and Quicklinks to your iPhone and iPad whilst on the go. Deep integration with iOS features including widgets, shortcuts, and a keyboard means Raycast works naturally across your apps too.
> [!TIP]
> Add Raycast shortcuts for AI Chat, Calculator, and Notes to your Home Screen for quick access. Learn more on [Ray.so](https://www.ray.so/ios-icons).
- [AI](https://manual.raycast.com/ai): Raycast AI, whenever and wherever you need it
- [Notes](https://manual.raycast.com/notes): Notes that live in Raycast, on every device
- [Quicklinks](https://manual.raycast.com/quicklinks): Open your favourite sites in a single tap
- [Snippets](https://manual.raycast.com/snippets): Saved text, ready whenever you need it
- [Keyboard](https://manual.raycast.com/ios/keyboard): Bring Raycast power to every text field
- [Widgets & Controls](https://manual.raycast.com/ios/widgets-and-controls): Quick access to Raycast from your home screen
- [Apple Shortcuts](https://manual.raycast.com/ios/apple-shortcuts): Trigger Raycast actions from the Shortcuts app
- [Share Extension](https://manual.raycast.com/ios/share-extension): Share links, text, and files directly into Raycast
### Keyboard
Source: https://manual.raycast.com/ios/keyboard
Description: Add Raycast as a keyboard on iOS to access AI Commands, Dictation, Snippets, and Quicklinks in any app you type in as a secondary keyboard.
Platforms: iOS
Last updated: 12 May 2026
The Raycast Custom Keyboard on iOS gives you direct access to your favourite Raycast features across every app on your phone.
> [!NOTE]
> The custom keyboard is designed as a _secondary_ keyboard. It doesn't replace your everyday typing keyboard — instead you'll use the Globe key icon in the bottom left to switch to Raycast when you need to access your content.
#### Setup
You can set up the custom keyboard by following the onboarding flow in Settings. You'll be guided and redirected to System Settings to toggle the keyboard and **Allow Full Access**. Enabling **Allow Full Access** is essential to the keyboard's functionality.
[Watch video](https://manual.raycast.com/videos/app/ios/keyboard/install.mp4)
#### Features
The custom keyboard is packed with your favourite Raycast iOS features.
##### AI & AI Commands
You can run AI Commands on content in the active text field. By default, it uses the full content of the input. However, you can also select specific text if you only want to run a command on a portion of the input.
[Watch video](https://manual.raycast.com/videos/app/ios/keyboard/fixspell.mp4)
##### Dictation
Tap Waveform button on the keyboard to dictate into any text field. The first tap opens Raycast to start recording, then maintains a 5-minute background session so subsequent dictations skip the redirect. Format with built-in **Email** and **Notes** styles, or pipe through any custom AI Command.
See the [Dictation page](https://manual.raycast.com/ai/dictation) for recording controls, languages, and post-processing.
[Watch video](https://manual.raycast.com/videos/app/ios/keyboard/dictate.mp4)
##### Quicklinks
Effortlessly share your Quicklinks with others from the keyboard. Dynamic placeholders also work for more advanced links.
[Watch video](https://manual.raycast.com/videos/app/ios/keyboard/quicklink.mp4)
##### Snippets
Breeze through your emails, or access your library of symbols. Dynamic placeholders also work here.
[Watch video](https://manual.raycast.com/videos/app/ios/keyboard/snippet.mp4)
##### Recents
The first thing you'll see when switching to the Raycast keyboard is a tile of recent items. This gives you quick access to the commands and content you use most frequently.
#### Settings & Customization
There's a few settings and options to configure for the custom keyboard. All accessible through **Settings → Keyboard**.
##### AI Model
For the Ask AI command, you can select the AI model to be used.
##### Languages
You can configure which languages the typing keyboard supports — used when typing in Search, Ask AI, or Dynamic Placeholders.
To switch language, long-press the bottom right of the space bar.
[Watch video](https://manual.raycast.com/videos/app/ios/keyboard/LanguageSwitch.mp4)
##### Dictation Insert
By default, the dictation output is added to the input automatically — the most efficient workflow. If you'd prefer a review step before inserting the output, you can change this setting.
##### Recording Disabling
By default, a dictation session is set up when you first use dictation. It lasts 5 minutes, allowing you to start more quickly without redirecting to the main app. You can change this to disable immediately — meaning each time you use dictation you'll be redirected to the main app to start the recording.
##### Switch to Next Keyboard
This setting is disabled by default. When enabled, if you dismiss the keyboard, then on reactivation you'll be switched back to the next keyboard. So if you have your primary keyboard alongside Raycast, dismissing while Raycast is active will switch you back to your primary keyboard.
#### Discover More Tips
Pedro recorded a walkthrough video for the keyboard, sharing tips and ideas on how to best use Raycast Keyboard on iOS.
[Watch on YouTube](https://www.youtube.com/watch?v=lta7_MCTzxo)
### Widgets & Controls
Source: https://manual.raycast.com/ios/widgets-and-controls
Description: Put Raycast on your home screen, lock screen, and Control Center with widgets and controls — instant access to AI, voice, and custom commands.
Platforms: iOS
Last updated: 28 April 2026
Customize your iPhone with Raycast widgets and controls so your most-used commands are always within reach — on the home screen, lock screen, and Control Center.
#### Widgets
##### Home Screen
Customize your home screen with the AI Widget — quickly trigger the camera, voice, or Ask AI — or use the Favorites widget to surface your most-used commands.
###### Adding a Widget
1. On your home screen, hold down until your apps begin to wiggle.
2. Tap the **+** in the top left.
3. Search for **Raycast**.
4. Tap Raycast and browse the widgets.
##### Lock Screen
Customize the lock screen with a set of actions, like Open Voice, Create Note, Snippets, and more.
###### Adding a Widget
1. Lock your device.
2. Long-press the screen.
3. Tap **Customize**.
4. Tap **Lock Screen**.
5. Tap **Add Widgets**.
6. Search for **Raycast**.
7. Tap or drag a widget.
8. Dismiss the sheet.
9. Tap **Done** in the top right.
#### Controls
Controls are much like widgets or shortcuts, giving you quick access to frequently used actions. Controls live on your Lock Screen (replacing the camera and torch buttons in the bottom corners) or in Control Center (swipe from the top right).
You can add a control to start a new AI Chat, Open Camera Attachment, or Create Note.
##### Add to Lock Screen
To replace the Torch or Camera control on your lock screen:
1. Lock your device.
2. Long-press the screen.
3. Tap **Customize**.
4. Select **Lock Screen**.
5. Tap minus on the existing control to remove it.
6. Tap **+** to add a control.
7. Search for **Raycast**.
8. Select your control (Ask AI, Open Camera, Open Voice, etc.).
9. Tap **Done** (top right) to save.
##### Add to Control Center
To add a control to Control Center:
1. Swipe down from the top right.
2. Tap the **+** button (top left).
3. Tap **Add a Control** (bottom).
4. Search for **Raycast**.
5. Select your control (Ask AI, Open Camera, Open Voice, etc.).
6. Drag a corner to resize, or drag to rearrange.
7. Tap an edge to exit edit mode and return to Control Center.
### Apple Shortcuts
Source: https://manual.raycast.com/ios/apple-shortcuts
Description: Connect Raycast to Apple Shortcuts on iOS. Run Ask AI, AI Commands, and Open Voice from Spotlight, custom shortcuts, or your iPhone's Action Button.
Platforms: iOS
Last updated: 28 April 2026
Enhance your experience and access Raycast across iOS without switching context with our set of Apple Shortcuts. Perform actions quickly outside of the Raycast app or use them to automate repetitive tasks.
#### Accessing Default Actions
You can access Ask AI, AI Commands and Open Voice shortcut actions through the Shortcuts app, or by searching in Spotlight Search.
#### Building Custom Shortcuts
You can go one step further and integrate one of our many actions into a shortcut — like using Ask AI to fill out a Linear issue from a brief description.
#### Action Button
If your iPhone has an Action Button, you can choose which function you want it to perform when you press it. Raycast Shortcuts can be triggered straight from the Action Button — like Ask AI or opening a specific Raycast Note.
##### Setting an Action Button Action
1. Open Settings and search for **Action Button**.
2. Swipe until you see the **Shortcut** option.
3. Tap the button to select a Shortcut.
4. Search for **Raycast**.
5. Select one of the built-in actions or any custom shortcut that uses Raycast.
### Share Extension
Source: https://manual.raycast.com/ios/share-extension
Description: Run Raycast AI Commands on any text in iOS via the Share Extension — rewrite, translate, summarise, or trigger a custom command from any app.
Platforms: iOS
Last updated: 28 April 2026
The Share Extension on iOS gives you access to your AI Commands from almost any app.
#### Running AI Commands
To run an AI Command, select text and swipe across the selection menu until you find **Share**. Look for the Raycast app to initiate the share extension. You should see your list of built-in and custom AI Commands which you can tap to run.
#### Add to Favorites
You may wish to add Raycast to your favorites — this means it'll always appear in the first set of apps in the share sheet, making it easier to access and run AI Commands.
## Account
### Account Management
Source: https://manual.raycast.com/account-management
Description: Discover how to manage your entire Raycast account in one place. Update account settings, polish your profile, control billing, and see your organization in Teams.
Last updated: 14 May 2026
You can control and manage your Raycast account from the [Raycast website](https://www.raycast.com/settings/account). Sign in to edit your account details, update your billing information, and review the organizations you belong to.
#### Account
- **Developer Credits**: Credits are awarded for creating and contributing to [Extensions](https://manual.raycast.com/extensions/). Details on redeeming credits are coming soon.
- **View Billing Info**: View and edit your subscription billing information. Learn more on [Billing](https://manual.raycast.com/billing).
##### Account Details
- **Email**: Change the email address associated with your Raycast account. You will be asked to verify the change via a confirmation email, and two-factor authentication if enabled, before it's updated.
- **Change Password**: Change your Raycast account password. You will be asked to verify your account with two-factor authentication before the change takes effect.
- **Two-Factor Authentication**: Enable or disable an additional layer of security on your account when signing in, or when taking sensitive actions.
- **Delete Account**: Delete your Raycast account permanently.
##### Auth Providers
Add **Google**, **GitHub**, or **Apple** accounts to your Raycast account using the ** Add Account** button and use them as an authentication provider to sign in. You can connect multiple accounts under one auth provider, or remove them using the **Remove** button next to the account.
##### Extension Issues
Select whether you would like to receive a weekly email summary of issues for extensions you maintain on the [Store](https://manual.raycast.com/extensions#store). You can view and resolve the issues across all of your extensions on the [Extension Issues](https://www.raycast.com/extension-issues) portal.
#### Profile
Customize how your public profile appears on the Raycast website. Some information is also visible inside Raycast when browsing Extensions on the Store. Set your **avatar**, **full name**, **username**, **location**, **website**, **Twitter username**, **GitHub** handle, and **bio**.
Prefer to keep things private? Enable **Make Profile Private** and your profile won't be publicly accessible or appear in search results. Your email address is never shown publicly on the Raycast website or in the app.
#### Organization
When you're part of an organization in Raycast, you can find and manage related organization settings on this page.
- **View Billing Info** and **Change Billing Interval**: View and edit your organization billing information.
- **Cancel Plan**: Cancel your Raycast Teams Pro subscription. **Cancel Advanced AI** option will appear if your organization is subscribed to Teams Advanced AI.
##### Members
View the full list of members added to an organization, including their **full name**, **email address**, **role**, and their current **2FA** status.
- **Copy Invite Link**: Invite members to an organization from an invite link.
- **Reset Invite Link**: Rotate your invite link to a new one and invalidate the previous invite link.
- **Export Members**: Export a full list of an organization's members, including email address, handle, full name, role, and date added.
##### Create an Organization
Not yet in an organization? You can create an organization by selecting **Create an Organization**, then uploading an **organization avatar** and setting your **organization name** and **handle**.
### Billing
Source: https://manual.raycast.com/billing
Description: Manage your billing settings, payment methods, and subscription options for Raycast in one place.
Last updated: 29 April 2026
Raycast offers a number of subscription tiers in addition to free-of-charge features.
Each subscription tier unlocks features on an account basis and is valid across all platforms Raycast is available on. For instance, one Pro subscription entitles you to Pro features simultaneously on the macOS, Windows and iOS versions of Raycast, provided you are logged in to the same account on each device. You do not need separate accounts to use Raycast on different platforms.
#### Plans
##### Raycast
Free users have unlimited access to Raycast's core feature set, which includes Clipboard History, Snippets, Quicklinks, Calculator, Emoji Picker, Window Management, Hyper Key, and more, in addition to unlimited access to the Extensions Store and developer tooling.
Free users also receive a one-time 50 free messages to use with any Raycast Pro AI models to trial Raycast's AI features and can optionally use Raycast AI with their own compatible API key from other AI subscriptions (BYOK). Free users are also welcome to use Raycast AI with local models installed on their device via Ollama.
##### Raycast Pro
Pro users receive everything included with the Free plan, plus Raycast AI, Cloud Sync, Translator, Unlimited Raycast Notes, Unlimited Clipboard History, Custom Window Management and Custom Themes.
Raycast Pro can be billed either Monthly or Yearly.
##### Raycast Pro + Advanced AI
Advanced AI is an add-on to the standard Pro plan. It contains everything in the Pro plan, plus access to the best available AI models.
For more information about the AI models available on the Pro and Advanced AI plans, please refer to the [models page](https://www.raycast.com/core-features/ai/models).
##### Raycast for Teams
The Free tier of Raycast for Teams gives each team member the same as an individual Free account, as well as up to 5 Shared Custom Extensions, 30 Shared Snippets and 30 Shared Quicklinks.
##### Raycast for Teams Pro
Everything included in the individual Raycast Pro subscription, along with unlimited Shared Custom Extensions, Shared Snippets and Shared Quicklinks.
#### Creating a free account
You can create your Raycast account from our website at [raycast.com](https://www.raycast.com/).
Alternatively, if using the iOS version of Raycast, you can create a new account when launching the app for the first time — simply tap **Create Account** on the splash screen that appears on first launch or when the app is logged out.
#### Starting a new subscription
You can either create a free account first or start a new subscription right away. Head to the [Pricing](https://www.raycast.com/pricing) section of our website and choose a subscription and billing interval.
If you're using the iOS version, you can sign up for a subscription whilst creating your account, or login to your free account and open Settings. Either tap **Try Free** at the top of the Settings page to begin a 14-day trial of the Pro subscription, or tap **Subscription** to choose from other tiers.
#### How you are billed
Billing works identically whether you are on an Individual plan or a Teams plan. Enterprise customers should contact us directly at [enterprise@raycast.com](mailto:enterprise@raycast.com).
##### Pro
###### Trial period
When a new user starts a Yearly or Monthly Pro subscription, they begin with a 14-day free trial. When the trial period ends, you will automatically be billed either the Yearly or Monthly amount, depending on the billing cycle chosen at checkout. To avoid being charged, you can cancel before the trial period ends via your [Account Settings](https://www.raycast.com/settings/account).
Each user account is entitled to one free trial. If you end your subscription and resubscribe later, your new subscription will begin billing immediately with no new trial period.
###### Monthly billing
With a Monthly subscription, you'll first be billed on the day your trial period ends (14 days after you signed up) and then again on the same date every month. For instance, if you began your first Pro subscription on the 3rd March, you'll receive a 14-day free trial and then be billed for your first full month on 17th March, then 17th April, then 17th May, and so on until you end the subscription.
###### Yearly billing
Yearly subscriptions receive a 20% discount over Monthly subscriptions. With the Yearly subscription, you'll first be billed on the day your trial period ends (14 days after you signed up) and then again on the same date the following year. For instance, if your trial ends on 14th March 2026, you'll be automatically billed for the following year on 14th March 2027, then again on 14th March 2028, and so on until you cancel.
###### Auto-renewal
Both the Monthly and Yearly Pro subscriptions automatically renew. You'll be billed at the next billing date unless you cancel before.
###### Cancelling your subscription
You can end your subscription at any time from your [Account Settings](https://www.raycast.com/settings/account). This will end your auto-renewal. You'll continue to receive your Pro benefits right up until your renewal date and will then revert to a Free account.
##### Advanced AI
Advanced AI is an add-on to your Pro subscription. You will need an existing Pro subscription in order to add it.
You can begin and end an Advanced AI subscription at any point during your Pro subscription. You will always be billed on the same renewal cycle as your Pro subscription — for instance, if you are on a Yearly Pro subscription, you will be billed for a Yearly Advanced AI subscription.
Because you can begin and end your Advanced AI subscription at any point, if you add Advanced AI part-way through your Pro subscription, you will be billed a pro-rata amount for the time remaining until your next Pro renewal date. If you end your Advanced AI add-on before your next Pro renewal date, you'll be automatically issued a pro-rata refund for the time unused.
#### Managing your subscription
**For subscriptions started from the Raycast website**
Head to your [Account Settings](https://www.raycast.com/settings/account). From here, you'll be able to:
- Upgrade your subscription tier with Advanced AI.
- Remove Advanced AI from your subscription.
- Change your billing cycle from Monthly to Yearly.
- View and update your billing card/method.
- View your invoices.
- Cancel your subscription.
Please note, you cannot make changes to a subscription if you have an invoice that is currently open.
**For subscriptions started from the Raycast iOS app**
Open the Raycast app, then head into Settings (the icon on the top right of the screen — usually your initials or profile photo). Tap **Subscription**, then **Manage Subscription**. This will take you to the App Store, where you'll be able to change your plan, your billing cycle, or cancel your subscription.
Alternatively, open the iOS App Store, tap Settings (top-right icon), then tap **Subscriptions**.
> [!WARNING]
> If you created a subscription on iOS, you must manage it via your iOS device. We cannot cancel or
> make changes to subscriptions created via the iOS App Store.
#### Frequently Asked Questions
##### Do I need a subscription to use Raycast?
No, our Free plan is totally free, forever!
##### Do I need separate accounts to use Raycast on Mac, Windows and iOS?
No, you only need one Raycast account to access the same features on each platform that account is logged into.
##### Which payment methods do you accept?
We accept all major payment cards: Visa, Mastercard, American Express, Discover, Diners Club, JCB, and UnionPay through our billing partner, Stripe. We also accept PayPal.
##### How do I change the payment method for my subscription?
Head to your [Account Settings](https://www.raycast.com/settings/account) and click **View Billing Info**. You'll be able to update your payment method there.
##### Which currencies do you support?
We support payments in US dollars (USD).
##### Do you offer any trials or discounts?
New users can trial Raycast Pro free for 14 days.
Raycast offers a Pro plan 50% discount to verified students. You can apply by completing [this form](https://raycastapp.typeform.com/to/hSoIknLJ). Please note that the student discount only applies to the Raycast Pro plan, and not the Advanced AI add-on.
##### Something went wrong at checkout?
Please contact us at [billing@raycast.com](mailto:billing@raycast.com) and we'll sort it out for you as soon as possible!
##### What happens if a payment fails?
We'll send an email to the billing contact if a payment doesn't go through. You can easily update your card details anytime from your [Account Settings](https://www.raycast.com/settings/account).
Our system will automatically retry the payment over the next few days. If payment still does not go through, you'll be reverted back to our free plan. Please reach out to us at [billing@raycast.com](mailto:billing@raycast.com) if you need any assistance.
##### I paid my overdue invoice but my Pro subscription did not reactivate?
Pro subscriptions don't automatically renew after paying an overdue invoice. Reach out to us at [billing@raycast.com](mailto:billing@raycast.com) and we'll get this reactivated for you.
##### My student discount code shows invalid at checkout?
Student discount codes can only be used once, so if you previously used one for a Pro subscription that you've since ended, it will not work again if you resubscribe. If you're still a verified student, contact us at [billing@raycast.com](mailto:billing@raycast.com) and we can issue you with a new one.
##### I've paid for a Pro subscription, but don't seem to have unlimited Clipboard History?
You need to enable unlimited Clipboard History manually. Head into Raycast's Settings → Clipboard History and change the **Keep history for…** setting to your liking ("unlimited" is one of the options).
##### I'm unable to upgrade to Advanced AI?
If you've set your Pro subscription to cancel, or if you have an outstanding invoice, you won't be able to upgrade to Advanced AI. Please check your [Account Settings](https://www.raycast.com/settings/account).
- If your Pro subscription is set to cancel, you can reverse this there.
- If you have an outstanding invoice, you'll be able to check and correct your billing details there.
##### Who can I contact if I have other issues?
Please reach out to us at [billing@raycast.com](mailto:billing@raycast.com).
### Raycast Teams
Source: https://manual.raycast.com/teams
Description: Bring your team together in Raycast with private extensions, shared Snippets and Quicklins, and Pro AI.
Raycast Teams brings your organization together with private extensions, shared Quicklinks, shared Snippets, and team-wide controls to standardize how your team works. Teams makes it easy for everyone to access the same tools and processes, reducing friction and keeping your organization aligned.
> [!NOTE]
> Some Teams features are available in Raycast for Mac v2 and Windows, with full support coming in future updates. Raycast v1 and iOS remain unchanged.
- [Getting Started with Teams](https://manual.raycast.com/v1/getting-started-with-teams): Set up your Raycast organization and invite your team
- [Roles & Permissions](https://manual.raycast.com/teams/roles-and-permissions): Control what each member of your team can do
- [Shared Features](https://manual.raycast.com/teams/shared-features): Share Snippets, Quicklinks, AI features, and more across your organization
- [Shared Extensions](https://developers.raycast.com/teams/publish-a-private-extension): Publish private extensions for your organization
### Roles & Permissions
Source: https://manual.raycast.com/teams/roles-and-permissions
Description: Understand the Manager, Billing, and Member roles in Raycast organizations and what each can do, from inviting members to configuring Enterprise controls.
Last updated: 04 June 2026
> [!NOTE]
> Some Teams features are available in Raycast for Mac v2 and Windows, with full support coming in future updates. Raycast v1 and iOS remain unchanged.
Raycast organizations support 3 user roles with different permission levels: **Manager**, **Billing**, and **Member**. Roles are assigned by Managers in the Members section of the Organization Settings page.
Throughout this page, **shared features** refers to Snippets, Quicklinks, AI Commands, Agents, Skills, and Dictation Styles shared with the organization. Private extensions are managed separately through the Private Store.
#### Manager
The Manager role has full administrative control over the organization:
- Access the complete list of organization members, including name, email, role, and **2FA status***
- Create, edit, and delete shared features
- Remove extensions from the Private Store
- Export information about organization members
- View and update billing details
- Edit organization details such as name and avatar
- Manage subscription (upgrade, cancel, reactivate, or change billing interval)
- Invite new members to the organization using an invite link
- Remove members from the organization
- Modify the roles of organization members
- Reset the invite link (if invitations are enabled)
- **Enterprise** Enable or disable enforcement of 2FA
- **Enterprise** Add or remove organization AI API keys (when BYOK is enabled)
- **Enterprise** Configure all Admin Controls, AI Control Center settings, the Extensions Allow-List, and MCP Servers
#### Billing
The Billing role can manage billing and view member information:
- Access the complete list of organization members, including name, email, and role
- Create, edit, and delete shared features
- Remove extensions from the Private Store
- Export information about organization members
- View and update billing details
#### Member
The Member role has basic visibility:
- Access the complete list of organization members, including name, email, and role
- Create, edit, and delete shared features
- Remove extensions from the Private Store
#### Roles & Permissions Comparison
| Permission/Action | Member | Billing | Manager |
|---------------------------------------------------------------------|:------:|:-------:|:-------:|
| Access full org member list: name, email, role, and **2FA status*** | | | Yes |
| Create, edit, and delete shared features | Yes | Yes | Yes |
| Remove extensions from the Private Store | Yes | Yes | Yes |
| Export org member information | | Yes | Yes |
| View and update billing details | | Yes | Yes |
| Edit organization details (name, avatar) | | | Yes |
| Manage subscription (upgrade, cancel, reactivate, change billing interval) | | | Yes |
| Invite new members using invite link | | | Yes |
| Remove members from the organization | | | Yes |
| Modify roles of org members | | | Yes |
| Reset invite link (if invitations enabled) | | | Yes |
| Enable or disable enforcement of 2FA* | | | Yes |
| Add or remove organization AI API keys (when BYOK is enabled)* | | | Yes |
| Configure all Admin Controls, AI Control Center settings, Extensions Allow-List, and MCP Servers* | | | Yes |
* These actions, including accessing 2FA statuses, are only available on Raycast for Enterprise
> [!NOTE]
> Want to learn more about Raycast for Enterprise in your organization? Send us an email at [enterprise@raycast.com](mailto:enterprise@raycast.com).
### Shared Features
Source: https://manual.raycast.com/teams/shared-features
Description: Share Snippets, Quicklinks, AI Commands, Agents, Skills, Dictation Styles, and private extensions across your organization so everyone works from the same set of tools.
Platforms: Mac, Windows, iOS
Last updated: 04 June 2026
> [!NOTE]
> Some Teams features are available in Raycast for Mac v2 and Windows, with full support coming in future updates. Raycast v1 and iOS remain unchanged.
Raycast Teams lets you share the building blocks of your workflow — Snippets, Quicklinks, AI Commands, Agents, Skills, Dictation Styles, and private extensions. Publish them once and every member gets the same setup, keeping your team aligned and onboarding fast.
Anything you share lives in your organization alongside your personal items, so members can tell at a glance what's theirs and what comes from the team. Members of any role can create, edit, and delete shared features; see [Roles & Permissions](https://manual.raycast.com/teams/roles-and-permissions) for the full breakdown.
#### Snippets
_(Available on Mac, Windows, and iOS)_
Share frequently used text — boilerplate replies, support macros, code stubs — so the whole team expands the same Snippets everywhere with Raycast. See the [Snippets page](https://manual.raycast.com/snippets) for more information.
#### Quicklinks
_(Available on Mac, Windows, and iOS)_
Put the dashboards, docs, and internal tools your team opens every day a single keyword away, with shared Quicklinks everyone reaches the same way. See the [Quicklinks page](https://manual.raycast.com/quicklinks) for more information.
#### AI Commands
_(Available on Mac and Windows)_
Roll out your best AI prompts — summarize a thread, polish copy, draft a reply — to the whole team, so nobody rewrites the same AI Command twice. See the [AI Commands page](https://manual.raycast.com/ai/ai-commands) for more information.
#### Agents
_(Only on Mac)_
Give the whole team a shared cast of Agents — a code reviewer, a support-reply writer, a researcher — each carrying the same instructions, model, and tools every time it's used. See the [Agents page](https://manual.raycast.com/ai/agents) for more information.
#### Skills
_(Only on Mac)_
Skills teach Raycast AI your team's way of working: publish your coding conventions, brand voice, and domain knowledge once, and they load in automatically whenever a chat calls for them. See the [Skills page](https://manual.raycast.com/ai/skills) for more information.
#### Dictation Styles
_(Only on Mac)_
Keep everyone's dictation on-brand with shared Styles for email, messaging, or meeting notes — one set of formats the whole team transcribes into. See the [Dictation page](https://manual.raycast.com/ai/dictation#styles) for more information.
#### Extensions
_(Available on Mac and Windows)_
Ship internal integrations as private extensions — your team installs them straight from your organization's Store, with nothing ever exposed on the public Store. See the [Publish a Private Extension guide](https://developers.raycast.com/teams/publish-a-private-extension) for more information.
## Resources
### Community Guidelines
Source: https://manual.raycast.com/community-guidelines
Description: Keeping the Raycast community welcoming to everyone with ground rules when engaging with the other users and Raycast staff.
Last updated: 28 April 2026
These guidelines have the goal of clarifying how we expect members of this community to behave. It is put in place in order to protect our members and clear expectations. These guidelines are effective immediately as of posting on August 14, 2023.
#### Encouraged
- Ask questions, make suggestions, and discuss with other community members and Raycast team members.
- Answer questions and give your opinion.
- Respect each other, and have empathy as everyone comes from a different path.
- Offer constructive criticism.
- Be polite.
- Promote your extension! We are as excited as you are when you get it shipped or have a brand-new update.
#### Not acceptable
- Spam content or messages without context – Of course, mistakes happen and can be fixed.
- Hate speech, sexism, racism, harassment, and personal threats.
- Copyrighted content for which you don't have the rights to use.
- Ideological, religious, and political discussions (there are better places for that!).
- Sharing explicit material – Let's keep this community PG-13.
- Misleading information.
- Bots – This is a community for human beings, leave the AI for Raycast prompts :)
- Impersonation.
- Vulgar language and slurs.
#### Consequences
By not following the above, the community managers and other members of the Raycast team may apply penalties according to this order:
- Warning of misbehavior via Direct Message;
- Suspension (deactivation of account) for 15 days;
- Ban from the community by deleting the account.
Warnings may or may not be provided in between penalties. If the content is offensive to the community, the Raycast team, or Raycast as a company, it may be removed before a warning is issued.
#### Reporting
Our community managers are here to help! Contact **Stephanie Leong** or **Per Nielsen Tikær** if you think someone is not following our guidelines or you don't feel safe in our community. Raycast is built for the community and by the community. Together we can make this great!
### Extensions Guidelines
Source: https://manual.raycast.com/extensions-guidelines
Description: Guidelines for building, submitting, and maintaining high-quality Raycast Store extensions, including review process, requirements, and publishing tips.
Last updated: 28 April 2026
Extensions play an important role in the Raycast ecosystem. These Extensions Guidelines help ensure we can continue providing quality extensions for all Raycast users. The [Community Guidelines](https://manual.raycast.com/community-guidelines) also apply when you interact with users, fellow developers, and Raycast staff.
#### Definition
A Raycast Extension is code written by Raycast or third-party developers that extends Raycast's functionality. They typically integrate external services into Raycast, though extensions can also perform local actions, provide utilities, and more.
#### Creation and Review Process
##### Create your extension
Fork an existing extension or start from scratch. Setup instructions are available in the [Developers Getting Started](https://developers.raycast.com/basics/getting-started) guide.
##### Submit your extension
Submit your extension to be reviewed by opening a PR in the [Raycast Extensions repository](https://github.com/raycast/extensions).
##### Wait for review
The Community Managers review extensions first-in, first-out. You can expect first contact within a week, subject to Community Manager availability.
##### Respond to feedback
Answer the reviewer's comments promptly to ensure there's no delays in your submission review. Unanswered PRs will go stale and, eventually, be closed without approval.
To keep the backlog focused on extensions under active development, Pull Requests follow this lifecycle:
- Marked as stale after 14 days of inactivity since the last comment.
- Closed after 21 days of inactivity since the last comment.
- Stale or closed PRs can be re-opened whenever you're ready to pick them back up.
##### Published!
After your extension has been reviewed and approved by the Community Managers, your extension will be available on the [Raycast Store](https://raycast.com/store) for anyone to download.
#### Before Acceptance
##### Value & Uniqueness
- Make sure your extension is bringing value to Raycast users;
- We want your extension to bring something that Raycast or other extensions don't provide yet.
- At the same time, we prefer to keep services grouped in one extension and would rather increment an existing extension than create a new one.
- Your extension should do more than Raycast's native features (Quicklinks, Snippets, Clipboard History, Calculator, etc.) already provide.
- Fun is a great value for Raycast! Just make sure that it is non-violent and respectful.
##### Quality & Documentation
- Make sure the extension works and that users have all the information they need to set it up and use it;
- This information should be in the extension's README file.
- State codes, APIs, credentials, and any other relevant information that the user might need to connect your extension and the service.
- All information collected from the user should not be used for any purpose other than connecting to the service and improving the extension's response.
#### After Acceptance
- You are responsible for your extension and any issues or feature requests that come up.
- You can easily keep track of them on the [Developer Hub](https://www.raycast.com/extension-issues).
- In case of a major bug in a popular extension (more than 1k downloads), Raycast has the right to step in to fix the issue as soon as possible.
- Normally, this is done in conjunction with the Author or the developers from the service provided by the extension.
- In case of abandonment, Raycast has the right to write and approve fixes without the extension Author's consent.
- Abandonment is defined as: the extension no longer functions, OR the Author hasn't responded to Raycast team contact (3+ attempts).
- Stalled PRs are also considered abandoned by the extension's Author.
- Raycast reserves the right to build extensions with the same functionality as an existing one.
- In that case, the Author will be informed in advance.
- The existing extension does not need to be removed from the Store.
#### Reasons to be rejected
- Violates our [Terms of Service](https://www.raycast.com/terms-of-service) and/or [Privacy Policy](https://www.raycast.com/privacy). This includes, but is not limited to the following;
- Providing access to content not intentionally made available or provided for through the Service.
- Impersonation.
- Promoting criminal activity.
- Violates the Terms of Service of the service provided. Example: scraping a website without permission.
- There is already a feature to accomplish this directly in Raycast, which offers comparable value.
- There is an active extension on our Store providing very similar value.
- We encourage the Author to iterate on existing extensions, add new functionality, fix bugs, or even re-write it.
- There is an open PR for an extension providing very similar value.
- The extension does not follow our [technical guidelines](https://developers.raycast.com/basics/prepare-an-extension-for-store).
- The extension's name uses restricted words. Currently, we are restricting the use of the word "Assistant".
#### Featured Extensions
Every month, our Community Managers choose 3 extensions to feature on the Raycast Store. Featured extensions receive prominent visibility for one month, both online and in the app. We select based on:
- Innovation and creativity.
- Popularity and demand.
- Extensions that haven't been featured before.
Official extensions from our partners may receive priority consideration.
#### The Future of Raycast Developer API and Breaking Changes
Raycast may make breaking changes to our API in the future. Here's what this means for extension developers:
- A plan will be published beforehand.
- A guideline will be provided by Raycast's engineers on how to proceed, the changes made, and the consequences.
- Raycast engineers will be available to help with migration.
- Authors will be responsible for migrating their extensions.
### Raycast Recipes
Source: https://manual.raycast.com/raycast-recipes
Description: Practical workflows that combine Raycast features so everyday tasks shrink down to a single keystroke.
Platforms: Mac, Windows
Last updated: 02 June 2026
Anyone can boil an egg. The magic is in the combinations.
If you're new to Raycast, you might be using it for just one or two things: launching apps, doing quick sums. That's a great start. These recipes show you how to combine simple features so everyday tasks shrink down to a single keystroke. You don't need to be technical, and most recipes take under a minute to set up.
#### Stock your pantry first
A few ingredients show up again and again. Here's what they mean in plain terms:
- **Hotkey:** a keyboard shortcut that works anywhere on your Mac, even when Raycast is closed. Example: press Option + N to open Notes instantly.
- **Alias:** a short keyword you type into Raycast's search bar to jump straight to a command. Example: type tr to open Translate.
- **Quicklink:** a saved link, file, or app shortcut that opens in one step. Think of it as a smart bookmark.
- **Snippet:** a short keyword that expands into a longer piece of text as you type it, anywhere on your Mac.
- **Clipboard History:** Raycast remembers everything you copy, so you can go back and find it later.
You set most of these up in Raycast Settings. You can always reach Settings by opening Raycast and typing "Settings".
##### House Seasoning (Aliases)
*A two-letter shortcut for any command.*
**What it does:** Instead of typing a full command name, you type a tiny keyword you chose.
**How to make it:**
1. In Raycast, find a command you use often.
2. Press Command + K and choose "Add Alias" (or set it in Settings).
3. Pick something short, like et for Empty Trash.
**Why it helps:** Your most-used commands become muscle memory, and your chosen keywords never clash with anything.
##### The Master Stock (Hyper Key)
*One special key that powers all your shortcuts.*
**What it does:** Hyper Key turns a key you rarely use (usually Caps Lock) into a single "super modifier" shown as ✦. It acts like holding Control, Option, Command, and Shift all at once.
**How to make it:**
1. Go to Settings, then Keyboard, then Hyper Key.
2. Turn it on and pick Caps Lock.
3. Now set shortcuts like ✦ N for Notes or ✦ S for Slack.
**Why it helps:** These shortcuts never clash with other apps, because no app uses such an unusual combination. It's the foundation the other recipes sit on.
##### One-Press Lookup
*Translate or search a word the instant you see it.*
**What it does:** You highlight a word on your screen, press one key, and the translation or search result appears. No copying, no switching apps.
**How to make it:**
1. Open Raycast and search for "Create Quicklink".
2. Paste a search or translate URL (for example a dictionary or Google Translate link).
3. Where the search term would go, choose "Selected Text" as the input.
4. Give the quicklink a hotkey in its settings.
**Why it helps:** Looking something up usually means copy, switch app, paste, search. This turns all of that into a single press.
##### Copy-and-Go
*Jump straight to a page using whatever you just copied.*
**What it does:** You copy something like a ticket number, press a hotkey, and Raycast builds the full web address for you and opens it.
**How to make it:**
1. Create a Quicklink with the page's web address.
2. In the spot where the unique part goes, type `{clipboard}`. This tells Raycast to drop in whatever you last copied.
3. Add a hotkey.
**Why it helps:** You skip hunting for the right link. Copy, press the hotkey, and you're on the page.
##### Tiny Tool, Made to Order
*Build a mini search tool in about thirty seconds, no code.*
**What it does:** An "argument" just means the quicklink pauses to ask you for input before it opens, like a Translate that asks "which word?" and "which language?".
**How to make it:**
1. Create a Quicklink.
2. In the URL, add an argument placeholder where your input should go.
3. Now whenever you run it, Raycast asks you what to fill in.
**Why it helps:** You get a custom, single-purpose tool without installing or building anything.
##### Snippets That Cook Themselves
*Text that fills in the right details automatically.*
**What it does:** A snippet expands short text into longer text. "Dynamic placeholders" are little tokens that get replaced with live info when the snippet expands.
**How to make it:**
1. Open Raycast Settings and go to Snippets.
2. Create a snippet and give it a keyword (the trigger you'll type).
3. In the text, add placeholders like `{date offset="+7d"}` for "a week from today", `{clipboard}` for what you just copied, or `{cursor}` to set where your cursor lands.
**Why it helps:** A reply like "we'll get back to you by `{date offset="+7d"}`" always shows the correct date, with no edits from you.
##### Let the Clipboard Do the Shopping
*Turn things you copy often into reusable snippets.*
**What it does:** Raycast notices you keep copying the same text, and lets you save it as a snippet in two steps.
**How to make it:**
1. Open Clipboard History in Raycast.
2. Select an item you copy often.
3. Press Command + K to open the Action Panel, then choose "Save as Snippet".
**Why it helps:** If you paste the same thing twice a week, this saves you finding and copying it ever again.
##### Fill the Bento (Paste Sequentially)
*Fill out a whole form from your clipboard in one pass.*
**What it does:** You copy several things, then paste them one after another into different fields, in order.
**How to make it:**
1. Copy each value you need, one at a time.
2. In the form, use Raycast's "Paste Sequentially" action to drop them in field by field.
**Why it helps:** No more bouncing back and forth to copy each value separately.
##### Read the Label (OCR)
*Pull text out of a screenshot or image.*
**What it does:** "OCR" means reading text inside an image. Raycast can find images by the words inside them and let you copy that text out.
**How to make it:**
1. Open Search Screenshots in Raycast.
2. Search for a word you know is inside an image.
3. Open the result and copy the text from it.
**Why it helps:** You can grab text from pictures, screenshots, or scans without retyping it.
##### The Slow Cooker (Pinned Calculator)
*A live countdown that's always one search away.*
**What it does:** Raycast's calculator handles more than maths. It does dates too, like "days until 1 Aug". Pin the result and it keeps updating.
**How to make it:**
1. In Raycast, type something like `days until 1 Aug`.
2. Open Calculator History and pin the result.
**Why it helps:** Your countdown stays live and visible, no need to recalculate it each time.
##### Same Recipe, New Pan
*Use the lookup trick with apps from the Store.*
**What it does:** Extensions are add-ons from the Raycast Store that connect Raycast to other apps (Linear, GitHub, Spotify, and more). They work just like built-in commands, so the same wiring applies.
**How to make it:**
1. Install an extension from the Raycast Store.
2. Give one of its commands a hotkey, and set it to use selected text as input.
**Why it helps:** Once you learn one combo, it works everywhere. Nothing new to learn for each app.
##### Hand the AI Your Knives
*Let Raycast AI use your installed extensions for you.*
**What it does:** In AI Chat, typing @ shows your extensions as tools the AI can use, like @calendar or @linear.
**How to make it:**
1. Open AI Chat in Raycast.
2. Type @ and pick an extension.
3. Ask in plain language, for example "add lunch to my calendar tomorrow at noon".
**Why it helps:** You describe what you want in normal words, and the AI handles the steps.
> [!NOTE]
> AI features may require a paid plan, though you can bring your own API key.
##### Write Down the Family Recipe (Skills)
*Teach the AI how you like things done.*
**What it does:** A "Skill" is a short text file (SKILL.md) where you write your preferences and conventions. Raycast loads it automatically when it's relevant.
**How to make it:**
1. Create a folder with a SKILL.md file inside.
2. Write down how you like a task done (your style, your rules).
**Why it helps:** The extension lets the AI do something; the skill makes sure it does it your way, without you re-explaining each time.
> [!NOTE]
> This one is more advanced, so save it for when you're comfortable with the basics.
> [!TIP]
> Start small. Pick one thing you do with your mouse five times a day, and turn it into a single keystroke using one recipe above. Once that feels natural, add another. Bit by bit, Raycast goes from "the app I open to launch things" to "how I run my whole day".
### Troubleshooting
Source: https://manual.raycast.com/troubleshooting
Description: Steps to diagnose and fix common Raycast issues on Mac, Windows, and iOS, plus how to gather the right information before reaching out to the team.
Platforms: Mac, Windows, iOS
Last updated: 18 May 2026
If something isn't working as expected in Raycast, this page walks you through the steps you can take yourself, the diagnostic information that helps us pin down what's going wrong, and how to send it to the team.
The steps below cover Raycast for Mac, Windows, and iOS. Where the platforms differ, you'll see specific instructions for each. Working through this list before reaching out usually shortens the back-and-forth and gets you to a fix faster.
#### Try these first
Most Raycast issues fall into a handful of common patterns. Before sending a report, run through these quick checks. They take a few minutes and resolve a large share of issues on their own.
##### Update Raycast to the latest version
**Mac**
In Raycast, search for `Check for Updates` and install any pending update.
**Windows**
In Raycast, search for `Check for Updates`, or open the Microsoft Store, go to `Library`, and update Raycast from there. Microsoft sometimes takes a while to roll out updates regionally.
**iOS**
Open the App Store on your device, tap your profile picture, scroll to `Available Updates`, and update Raycast. Several recent iOS bugs (AI Chat crashes, dictation glitches) were fixed in point releases, so updating alone often resolves the issue.
Many issues are fixed within one or two releases of being reported. If yours has been around for a while, the latest version may already have the fix.
##### Check that Raycast has the right permissions
Several Raycast features rely on explicit OS permissions. If a feature stopped working after a system update, this is the first place to check.
**Mac**
- Open `System Settings → Privacy & Security`.
- Confirm Raycast is enabled under `Accessibility` (needed for hotkeys and snippet expansion).
- Confirm Raycast is enabled under `Screen Recording` (needed for window management).
- If you use AI dictation, also check `Microphone`.
- If Raycast appears in a list but the toggle looks off, toggle it off and on again.
**iOS**
- To use the Raycast keyboard outside the app, open `Settings → General → Keyboard → Keyboards`, tap `Raycast`, and turn on `Allow Full Access`. Without it, AI Commands and dictation won't work from the keyboard.
- For dictation, open `Settings → Raycast` and confirm `Microphone` is enabled.
- If you're hitting login issues like "Token expired", check `Settings → General → Date & Time` and make sure `Set Automatically` is on. An incorrect clock blocks token validation.
##### Make sure only one version of Raycast is running
- Open `Activity Monitor` and search for `Raycast`. If you see two processes, quit the one you don't want to use.
- If you use both intentionally, make sure `Enable Snippet Expansion` is on in only one of them.
##### Check for conflicts with other tools
If a specific keyboard or text feature is misbehaving, another app on your device may be intercepting the same input. Common culprits:
- **Text expansion tools** (TextExpander, aText, Espanso, PhraseExpress, macOS Text Replacements) competing with Raycast Snippets.
- **Keyboard remapping tools** (Karabiner-Elements on Mac, AutoHotKey or Kanata on Windows, PowerToys Keyboard Manager, BetterTouchTool, Hammerspoon).
- **Other launchers or hotkey apps** bound to the same shortcut (Spotlight, Alfred, LaunchBar on Mac; Windows Search, PowerToys Run, Flow Launcher on Windows).
- **Antivirus or endpoint protection** on Windows occasionally quarantines parts of Raycast as `IDP.Generic` or similar. If features stop working suddenly, check your antivirus quarantine and add Raycast to the exclusion list.
- **Other custom keyboards on iOS** can interfere with the Raycast keyboard's text replacements and dictation. If a feature suddenly stops working, switch to the default keyboard temporarily to see whether the issue follows.
- Temporarily disabling the suspected tool helps confirm whether the conflict is real.
#### Common situations
If the first-aid steps didn't help, see whether your issue matches one of the patterns below. Each one expands with steps specific to that situation.
##### Raycast won't open, or crashes immediately on launch
**Mac**
- Download the latest version from https://www.raycast.com/new and reinstall by dragging the new app into `Applications` (replace the existing one when prompted).
- If reinstalling doesn't help, fully uninstall Raycast with AppCleaner, then install fresh.
**Windows**
- Open the Microsoft Store, search for Raycast, and click `Update` if one is available.
- If the install or update itself fails (for example with error `0x80073cf9`), repair the Microsoft App Runtime: `Settings → Apps → Installed apps`, search for `Microsoft Windows App Runtime Singleton`, open `Advanced options`, click `Terminate`, then `Repair`, then `Reset` if Repair fails. Install Raycast again.
**iOS**
- Update iOS to the latest version. Several reports of "app won't open" on iOS resolved after a system update.
- Delete the Raycast app and reinstall it from the App Store. This clears local state that can cause launch crashes.
- If reinstalling doesn't help, grab the iOS crash log so we can investigate. See `A crash report` in the section below.
If Raycast still won't launch after a reinstall on any platform, see `A crash report` in the section below.
##### Raycast is unresponsive, frozen, or stuck on a loading screen
- Quit Raycast (or force quit if needed) and reopen.
- If the freeze comes back immediately, restart your device.
- If the freeze happens in a specific situation (opening a particular extension, switching tabs in a specific view, typing a specific query, opening a specific AI Chat), note exactly what triggers it. Steps to reproduce are the single most useful piece of information you can give us.
**Mac**
Run `Copy Raycast Logs` before doing anything else.
**Windows**
Run `Copy Raycast Logs` before doing anything else.
**iOS**
Enable Engineering Mode and export logs (see `Raycast logs` below).
##### Raycast doesn't open at login / startup
**Mac**
- Open `System Settings → General → Login Items & Extensions` and confirm Raycast is in the `Open at Login` list and enabled.
- If it's already enabled but doesn't fire, remove it and re-add it. The macOS login-items database occasionally gets stuck.
**Windows**
- Open `Raycast Settings → General` and confirm `Open at Login` is enabled. On Windows, Raycast manages startup through Task Scheduler under the hood, so this setting is the source of truth (rather than `Startup Apps` in Task Manager).
- If you've enabled it but it still doesn't fire, update to the latest Raycast version. A series of fixes for autostart on Windows shipped in 0.56.2 and later.
- If a brief PowerShell or terminal window flashes during login, that's the Raycast startup launcher and is harmless.
**iOS**
Not applicable. The iOS app is launched on demand from the Home Screen, App Library, Spotlight, or via the Raycast keyboard from within other apps.
##### The Raycast keyboard doesn't work in other apps
_(Only on iOS)_
- Open `Settings → General → Keyboard → Keyboards`, tap `Raycast`, and turn on `Allow Full Access`. Without it, dictation, AI Commands, and clipboard-based features can't run.
- If commands aren't showing up on the keyboard, delete and reinstall the Raycast iOS app. Some users have resolved missing commands this way.
- If the keyboard appears but seems to crash or freeze a third-party app (for example Microsoft Word or Excel), check whether the same crash happens with the default iOS keyboard. Some app-side bugs are unrelated to Raycast even when the timing makes it look like the keyboard is the cause.
##### A keyboard shortcut doesn't fire
- Open `Raycast Settings > Shortcuts` and confirm the hotkey is still assigned. System updates occasionally clear hotkeys.
- Make sure another app isn't holding the same shortcut. If you suspect a conflict, temporarily disable the other app and try again.
**Mac**
- Open `System Settings → Privacy & Security → Accessibility` and confirm Raycast is enabled. Without it, no Raycast hotkey can register.
- If your hotkey is set through Karabiner-Elements or similar, that tool may take a few seconds to activate after your Mac wakes from sleep.
**Windows**
- Some shortcuts are reserved by Windows. `Ctrl+Esc` opens the Start menu, so the default `Pop to Root` binding is disabled on Windows. Other `Esc` combinations and various `Win+...` shortcuts are also reserved. Pick a combination that isn't claimed by Windows.
- If you use a non-US keyboard layout, watch for `Alt` combinations that conflict with `AltGr` characters. In the Raycast hotkey recorder, you can choose between a key-equivalent binding and a layout-independent binding.
- If your hotkey is configured through AutoHotKey, Kanata, or PowerToys Keyboard Manager, try disabling that tool and binding the hotkey directly inside Raycast as a test.
##### Snippets aren't expanding when I type the keyword
- Check that `Enable Snippet Expansion` is on in `Raycast Settings → Snippets`.
- As a quick reset, toggle `Enable Snippet Expansion` off, wait a moment, then turn it back on.
- Make sure your keyword doesn't contain spaces, quotes, or backticks. Those act as delimiters and prevent the keyword from matching.
- Some apps with custom text input (certain code editors, terminals, password managers) don't support text replacement. Try the snippet inside another app to confirm the issue is broader, or run `Search Snippets` and paste manually.
_(Only on Mac)_ Verify Raycast has Accessibility permission in `System Settings → Privacy & Security → Accessibility`.
##### Raycast is using a lot of memory
- Check the OS task viewer (Activity Monitor on Mac, Task Manager on Windows) to confirm the figure. Some third-party stats tools report inflated numbers.
- Quit and reopen Raycast. Memory should drop noticeably once it restarts.
- If you have very large file collections indexed, Raycast's file index can grow large. Add big or rarely-used folders to `Raycast Settings → File Search → Ignore Patterns` to keep the index smaller.
- If memory grows continuously over hours of use, that's a leak we want to know about. The steps below help us collect the data we need to investigate.
**Mac**
1. Quit Raycast fully via the menu bar icon or the `Quit Raycast` command, and wait a few seconds for it to disappear from Activity Monitor.
2. Clear existing logs: in Finder, press `⌘⇧G`, paste `~/Library/Logs/com.raycast.macos` (or `~/Library/Logs/com.raycast-x.macos` for Beta), and move the folder's contents to the Trash.
3. Relaunch Raycast and use it the way you normally do. Don't try to "force" the issue.
4. When you see a spike: note the exact time (with time zone), optionally screenshot Activity Monitor with Raycast expanded to show each subprocess, then run `Copy Raycast Logs`.
5. Send us the log files (from your clipboard) along with the time of the spike and any extra context (what you were doing right before).
**Windows**
1. Quit Raycast completely: right-click the system-tray icon → `Quit`, or use the `Quit Raycast` command.
2. Wait a few seconds for it to disappear from the system tray / Task Manager.
3. Clear existing logs: open File Explorer, paste `%LocalAppData%\Raycast` into the address bar, and delete the `Logs` folder.
4. Launch Raycast in Diagnostic Mode: open the Start menu, search for `Raycast`, and in the right-hand panel click `Diagnostic Mode`. This enables more verbose logging.
5. Use your computer as usual. Don't force the issue.
6. When you see a spike: note the exact time (with time zone), optionally screenshot Task Manager with Raycast expanded to show each subprocess, then run `Copy Raycast Logs`.
7. Send us the log files (from your clipboard) along with the time of the spike and any extra context (what you were doing right before).
Important: Raycast stays in `Diagnostic Mode` until you fully quit it. Diagnostic Mode is not persistent across reboots. After restarting your computer, Raycast starts in normal mode again unless you explicitly use Diagnostic Mode.
##### File Search is slow, missing files, or stuck indexing
- Open `Raycast Settings → File Search` and confirm the folders you expect are listed under `Search Scopes`.
- If indexing hangs on a very large folder, exclude it through `Ignore Patterns`.
**Mac**
Encrypted cloud-storage folders (for example Google Drive's `.Encrypted` folder) are a known hang point. Add these patterns to `Ignore Patterns`: `**/Library/CloudStorage/**/.Encrypted`, `**/Library/CloudStorage/**/.Encrypted/`, `**/Library/CloudStorage/**/.shortcut-targets-by-id`, `/Library/CloudStorage/**/.shortcut-targets-by-id/**`
**Windows**
Exclude network drives, virtual machine images, and large `node_modules` trees if you're indexing developer folders. Use the same `Ignore Patterns` field.
Quit and reopen Raycast so indexing restarts.
##### An extension crashes or behaves unexpectedly
- Try reloading the extension: in Raycast, search for the affected extension and run any of its commands again. Many transient failures clear on a re-run.
- Update the extension to the latest version from the Raycast Store (`Search Store` in Raycast).
- If the issue is reproducible, include the extension name and version (visible on its Store page) in your report.
- For locally developed extensions, make sure `@raycast/api` in your `package.json` is up to date and run `npm install` before `npm run dev` again. As a quick way to use the latest CLI without changing your `package.json`, run `npx @raycast/api@latest dev`.
##### Antivirus quarantined Raycast
_(Only on Windows)_
Some Windows antivirus tools occasionally flag Raycast as suspicious because it monitors clipboard contents and keystrokes, both of which are core to the launcher. The most common false positive is Norton's behavioural detection reporting `IDP.Generic`.
- Open your antivirus dashboard, find Raycast in the quarantine list, and restore it.
- Add Raycast to your antivirus exclusion / allow list so the same files aren't quarantined again.
- If the antivirus also deleted Raycast's startup task, you may need to reinstall from the Microsoft Store to re-create it.
#### Information to gather before reporting
When you do reach out, the more concrete information you can include, the faster we can reproduce and fix the issue. Most reports benefit from including each of the items below.
##### Your Raycast version and OS version
**Mac**
Raycast version: open `Raycast Settings → About`. macOS version: `System Settings → General → About` (for example `15.4`).
**Windows**
Raycast version: open `Raycast Settings → About`. Windows version: `Settings → System → About`. Note the edition (e.g. `Windows 11 Pro`), version (e.g. `24H2`), build (e.g. `26100.x`), and architecture (`x64` or `ARM64`).
**iOS**
Raycast version: open the Raycast app, tap your account avatar, then `Settings → About`. The version is also included automatically when you use `Share Feedback` from the iOS app. iOS version and device: `Settings → General → About`. Note both the iOS version (e.g. `26.4.1`) and the device model (e.g. `iPhone 18,1`).
If you're using a beta version of Raycast or your OS, please call that out.
##### Steps to reproduce the issue
This is the single most valuable piece of information you can send. We can fix something we can see happen; something we can't reproduce often stays open.
- Write down the exact sequence: which command you opened, which keys you pressed, which option you selected, what was different about your state (network offline, multiple monitors connected, specific app in focus, etc.).
- Include whether it happens every time or only sometimes.
- If the issue only happens in a specific app or text field, name that app.
##### Raycast logs
Raycast logs include enough detail for us to trace what happened internally without exposing personal data. They're small text files and easy to attach to a report.
**Mac**
- In Raycast, search for `Copy Raycast Logs` to copy the latest log file to your clipboard, or `Reveal Raycast Logs` to open the log folder in Finder.
- If Raycast won't launch at all, open Finder, press `⌘⇧G`, and paste `~/Library/Logs/com.raycast.macos` (or `~/Library/Logs/com.raycast-x.macos` if you use the Raycast Beta).
**Windows**
- In Raycast, search for `Copy Raycast Logs` or `Reveal Raycast Logs`.
- If Raycast won't launch, open File Explorer and paste `%LOCALAPPDATA%\Raycast\logs` into the address bar. Sort by date modified and grab the most recent files.
**iOS**
iOS log collection happens through Raycast's Engineering Mode. To enable it:
1. Open Safari and visit `raycast://engineering-mode-321`. When prompted, allow the link to open in the Raycast app.
2. Open Raycast, go to `Settings`, and you'll see a new `Engineering Mode` entry. Tap into it.
3. Reproduce the issue, then return to `Settings → Engineering Mode` and tap `Export Logs`. Share the exported file with your report.
While you're in Engineering Mode, also tap `Copy Anonymous ID` and paste the value into your report. This lets us look up any crash signatures we've received from your device.
##### A screen recording
A short recording is often clearer than any written description, especially for visual glitches or anything time-sensitive.
For Mac and Windows, the quickest way is [ray.so/v2-record](https://ray.so/v2-record). Open the link in your browser, click record, capture what's happening, and share the resulting link in your report. No install needed.
If you'd rather use a built-in tool:
**Mac**
Press `⌘⇧5` to open macOS's built-in screen recording controls. Choose `Record Selected Portion` to capture just the Raycast window, or `Record Entire Screen` if context outside Raycast matters.
**Windows**
Press `Win+Alt+R` to start a recording with the Xbox Game Bar, or open the `Snipping Tool` and use its built-in screen recorder.
**iOS**
- Add the `Screen Recording` control to Control Center: `Settings → Control Center` → tap `+` next to `Screen Recording`.
- Open Control Center and tap the record button. Reproduce the issue, then stop the recording from the red status bar at the top of the screen. The video saves to your Photos library; attach it to your report.
##### A crash report
If Raycast quits unexpectedly, your operating system generates a crash report you can send us. This contains the stack trace at the moment of failure, which is by far the most useful information for diagnosing launch and crash bugs.
**Mac**
- Open `Console.app` (from `Applications → Utilities`, or search for it in Raycast).
- In the sidebar, select `Crash Reports`. Find the most recent entry with `Raycast` in the name, click it, then use `File → Save As` or right-click → `Reveal in Finder`.
**Windows**
- Open `Event Viewer` from the Start menu.
- In the sidebar, expand `Windows Logs` and select `Application`.
- Look for entries with `Source` of `Application Error` or `.NET Runtime` that mention `Raycast.exe` around the time of the crash.
- Right-click each relevant entry, choose `Copy → Copy Details as Text`, and paste it into your report. Include the faulting module, exception code, and any stack frames you see.
**iOS**
- Open `Settings → Privacy & Security → Analytics & Improvements → Analytics Data`.
- Scroll to find entries that start with `Raycast` and look at the date and time to match the crash. Tap one to view it.
- Use the share button at the top right to send the file to yourself (Mail, AirDrop, etc.), then attach the file to your report. Pairing the crash report with the Anonymous ID from Engineering Mode is the most useful combination for iOS crashes.
Once you've gathered the information above, send it to us using the `Send Feedback` command inside Raycast (Mac and Windows) or the `Share Feedback` option inside the iOS app, or use one of the other channels listed on the [Contact Support](https://manual.raycast.com/contact-support) page.
### Contact Support
Source: https://manual.raycast.com/contact-support
Description: Learn how to get in touch with Rayacst Support to ask questions, report bugs, request billing help, or reach out to the Enterprise team.
Last updated: 27 May 2026
If you need help with Raycast, there's several ways to get in touch with Raycast Support.
#### Send Feedback Command
Need help? The best method is the [Send Feedback](raycast://extensions/raycast/raycast/send-feedback) command within Raycast. From there, you can share feature requests, report bugs, raise billing issues, or ask any other questions you may have. Alternatively, you can use the [Feedback form](https://www.raycast.com/feedback) on the Raycast website to get in touch with us.
#### Email Support
Prefer email? You can reach out to Raycast Support on the following email addresses best relating to your query:
- **General support or bug reports:** [support@raycast.com](mailto:support@raycast.com)
- **Billing queries:** [billing@raycast.com](mailto:billing@raycast.com)
- **Enterprise queries:** [enterprise@raycast.com](mailto:enterprise@raycast.com)
#### Slack Community
Join thousands of Raycast users on the [Raycast Community on Slack](https://raycast.com/community) to share tips, discover extensions, and get help from the people who use Raycast every day.