AI Extensions

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:

Root Search: type @ and find all AI Extensions. They start with “Ask…”
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.
AI Chat Presets / Settings. You can add AI Extensions to the list. You cannot @mention an AI Extension in the System instructions.

‣

Prompt examples

🤖

Note: AI Extensions are currently only supported in the Ray-1 and Ray-1 mini model.

You can find all available AI Extensions in the launcher, just type @

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.

An example of an ongoing chat, including the @calendar and @raycast-focus AI Extensions.

You can add AI Extensions in Chat settings, or to a Chat Preset to make it easier to reuse

AI Command with AI Extensions

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.

‣

Third-party extension prompt examples

To install third-party AI Extensions:

Open the Store in Raycast
Find and install an AI Extension. You can recognize them by the ⭐ icon.

💡

Tip: Filter by the AI Extensions category in the top-right dropdown. ⌘P

The extension store filtered by AI Extensions.

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.

AI Commands: ray.so/prompts
AI Chat Presets: ray.so/presets

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 in nicely in a table or use the additional @chart tool

You can add Custom Instructions in Raycast Settings → Extensions.

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.

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.

‣

How will my data be processed?

🛠️ 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

‣

Which models support AI Extensions?

‣

Is the Advanced AI add on required for AI Extensions?

‣

Can I use AI Extensions with a different model ?

‣

Do I need to select Ray-1 as the model in settings for Quick AI?

‣

I don’t see AI Extensions in AI Chat / How does it work in AI Chat?

‣

Why can I not add an @mention to the System Instructions in an AI Chat or Chat Presets?

‣

How do I find an AI Extension in the Store?

‣

How can I find good presets or examples of how to use AI Extensions?

‣

What underlying models are Ray-1 and Ray-1 mini based on?

‣

What’s the rate limit for Ray-1 and Ray-1 mini?

‣

What’s the context limit for Ray-1?

‣

@location isn’t working and it keeps asking for me to allow permission.