Skip to content
Pro

AI Extensions

This page only applies to Raycast for Mac V1. Latest information for Raycast for Mac V2, Windows, and iOS is available in the New Raycast Manual.

Raycast AI Extensions let you interact and instruct using natural language. Describe what you want to do, add the relevant AI Extensions to your message or chat, and let AI do the hard work

Getting Started

You can use one or multiple AI Extensions in a message, and then describe your intent. They are supported across Raycast AI. Here’s how to use them:

  1. Root Search: type @ and find all AI Extensions. They start with “Ask…”
  2. Quick AI, AI Commands, AI Chat message: type @ to find AI Extensions in a menu. You use them as an @mention inline. You need the Ray-1 model. New chats automatically switch to use this model when the message contains an AI Extension.
  3. AI Chat Presets / Settings. You can add AI Extensions to the list. You cannot @mention an AI Extension in the System instructions.

Screenshot of the AI commands in root search in Raycast V1
You can find all available AI Extensions in the launcher, just type @
Screenshot of the Calendar AI Extension in Raycast V1
AI Extensions in Quick AI. For any action that requires your attention before executing, Raycast will show a confirmation with a preview of what will be performed.
Screenshot of the Calendar AI Extension in AI Chat in Raycast V1
An example of an ongoing chat, including the @calendar and @raycast-focus AI Extensions.
Screenshot of the AI Extensions settings in AI Chat in Raycast V1
You can add AI Extensions in Chat settings, or to a Chat Preset to make it easier to reuse.
Screenshot of an AI command with AI extensions in Raycast V1
AI Command with AI Extensions.
Screenshot of all available AI Extensions in Preferences in Raycast V1
You can find all available AI Extensions in Settings by searching for @.

Third-party AI Extensions

But, that’s just the beginning — with third-party AI extensions the possibilities are endless.

To install third-party AI Extensions:

  1. Open the Store in Raycast.
  2. Find and install an AI Extension. You can recognize them by the ⭐ icon.
Filter by the AI Extensions category in the top-right dropdown. ⌘ P
Screenshot of the Store in Raycast V1
The extension store filtered by AI Extensions.
Screenshot of a list of AI Extensions on the extension store page in Raycast V1
The Spotify Extension, showing example prompts of what it can do when included in a message or chat.

Explore and get inspired

We prepared example prompts with AI Extensions on our platform ray.so for AI Commands and Chat Presets with AI Extensions. Explore what’s possible, install some, experiment with them and edit where needed.

Screenshot of an AI Chat Preset in Raycast V1
AI Chat Preset with AI Extensions

Custom instructions

Custom Instructions let you tell Raycast AI how you want it to use an extension. Some examples:

  • Calendar: Explain when to add a meeting link for Zoom or to Google Meet or describe how much free time to keep between meetings.
  • Finder: Describe your formatting of files and folders.
  • Linear: Let it know your preferred team, or the structure of filing bugs.
  • Weather: Specify which conditions you care to see - like temperature and precipitation - and display it nicely in a table or use the additional @chart tool.

You can add Custom Instructions in Raycast Settings → Extensions.

Screenshot of custom instructions for an AI Extension in Raycast V1
Custom Instructions for@weather. To jump directly into configuring extension’s settings, type @ in Root search to find any AI Extension, and then ⌘ ⇧, to open its settings.

AI Reliability

As with all things AI, reliability is a tricky thing to get right. In order to improve and continually make Raycast AI more reliably and useful, we need to understand what works and what doesn’t.

Providing feedback— the good and the bad - helps us to do this.

If you come across examples that do what you intended particularly well, or that missed the mark, you can report them to us by hitting the 👍 or 👎 button on the message.

Screenshot of rating Quick AI response in Raycast V1
A feedback prompt will show after each message with an AI Extension

When you report feedback, the full chat thread — including all AI Extension tool calls and results — will be sent to us. We handle this data with the same privacy and security as outlined in our ToS and Privacy Policy. However, please be mindful of any sensitive data the thread might contain.

Raycast doesn't use any user data or input to train AI/ML models. On the AI functionality we offer, we relay user input (not including user personal data) to the AI provider (OpenAI, Perplexity, Anthropic, etc.), through their API, which, according to their terms, none of them are allowed to process this data. Please see the section on our terms of service that refers to this.

Building AI Extensions

Do you want to build your own AI Extension? As part of our extension ecosystem, anyone can get started building and contribute to existing extensions. You can create an AI Extension from scratch or add AI functionality to an existing extension.

To get started, check out the developer documentation.

FAQs