Welcome to the Raycast AI Manual! This doc should help to familiarize you with the different features Raycast AI offers and how to get started using them. Here you’ll also find our approach to AI Privacy and Security, usage and request limits, and FAQs.
Table of Contents
- Raycast AI
- Quick AI
- AI Chat
- AI Commands
- 1. Built-in: Explain Words
- 2. Built-in: Improved Writing
- 3. Customize a built-in AI Command
- 4. Custom AI Command: Translate Text
- 5. Custom AI Command: Translate Text to Any Language
- Placeholders
- AI Extensions [Beta]
- Other AI features
- Image Generation
- Attachments in AI Chat
- AI Settings
- AI Feedback and Reliability
- Usage Limits
- Free messages for every user
- Request limits
- Raycast Pro models:
- Advanced AI models:
- Raycast AI FAQ
Raycast AI
These are the main ways to interact with AI in Raycast.
- Quick AI: It’s the fastest way to get answers to your questions directly from within Raycast. Ideal for one-off questions. Here’s a video to see it in action.
- AI Chat: A standalone chat window to ask AI anything. Ideal as an assistant during your workday.
- AI Commands: Built-in or custom prompts, ideal for common tasks such as improving your writing.
- AI Extensions: Include an
@-mention
to ask any extension a question or help you with your daily workflow. Check out the guide linked below or watch the video to learn more.
Quick AI
Follow the steps to ask AI anything:
- Open Raycast
- Type your question, f.e. “What were the specs of the first Macintosh?”
- Press
Tab
to switch to Quick AI - Perform your next action, e.g. press
⌘
J
to continue the conversation in the AI Chat
Some more noteworthy features:
- You can press
Tab
after opening Raycast to switch to Quick AI. This way you can access your previous question. - Quick AI is only for one-off questions. If you want to ask a follow up question, continue in the chat.
- You can hide the Ask AI
Tab
hint via Settings → Extensions → Raycast AI. TheTab
key still works.
AI Chat
Follow the steps to interact with the AI Chat:
- Open Raycast
- Search for “AI Chat” to open the spearate chat window
- Type in any question you want to start a conversation
- Continue the conversation with follow up questions
- Press
⌘
K
, select “Ask AI” and search for “Make Shorter” - Raycast applies the AI Command to shorten the previous message
⌥
J
) via Preferences → Extensions → Raycast AI → AI Chat
to open the chat quickerAI Commands
1. Built-in: Explain Words
- Select the word “philosophy”
- Open Raycast and search for “Explain This in Simple Terms”
- Raycast AI responds with the definition of the word “philosophy”
2. Built-in: Improved Writing
- Select a sentence, paragraph, or more text
- Open Raycast and search for “Improve Writing”
- Raycast AI responds with a text improved for grammar and style
3. Customize a built-in AI Command
To add a customized AI Command to your Raycast Root Search, continue with these steps:
- Go to “Search AI Commands” and find for example “Improve Writing”
- Press
⌘
D
to duplicate the AI Command - Give it a new title, for example “Improve Writing in My Personal Style”, change the icon to
Person Lines
, and the creativity to low - Tweak the Prompt, and define some rules that describe how you tend to write, for example: keep everything lowercase.
- Press
⌘
↵
to update the AI Command - Now you can use the AI Command from your Root Search
4. Custom AI Command: Translate Text
Follow the steps to create a new AI Command that translates selected text to any language:
- Open Raycast, search for “Create AI Command”
- Give it a Title like “Translate Selected Text to English”
- Type in the Prompt field “Translate {selection} to English” (or any other language) and hit
⌘
↵
to save - When you execute the AI Command, Raycast instantly shows a window with the translation of the selected text
5. Custom AI Command: Translate Text to Any Language
Follow the steps to create a new AI Command that translates selected text to any language:
- Create a new AI Command, or edit the one we just made by finding it and hitting
⌘
E
. - Name the Title something like: “Translate Selected Text to…”
- Change the prompt to use an Argument with a dynamic placeholder. Example:
Translate {selection} to {argument name="Language"}
- Press
⌘
↵
to update the AI Command - Now any time you execute the AI Command, you can define the language you want.
Dynamic Placeholders can be even more powerful. Learn more about them in the next section.
Placeholders
You can make your AI Commands dynamic with Dynamic Placeholders.
AI Extensions [Beta]
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.
Learn more AI Extensions
AI Extensions Include an @-mention
to ask any extension a question or help you with your daily workflow. Check out the guide linked below or watch the video to learn more.
Other AI features
Image Generation
OpenAI models allow you to generate images using DALL·E 2 or DALL·E 3. You can also use Stable Diffusion and Flux by finding them in Root search or including them in a prompt via an @-mention
. See AI Extensions to learn more.
Attachments in AI Chat
Provide more context in your chats using attachments.
Attachments in AI ChatAI Settings
Open Raycast Settings → AI Tab, and customize your experience: pick your favorite model for Quick AI, set the behavior of the AI Chat window, or set up a hotkey for Chat. You can also completely turn off and hide AI across Raycast with the big switch on the left side.
To completely turn off and hide AI across Raycast:
- Open Raycast Settings → AI Tab
- Use the big toggle switch on the left side
Or simply open the following deeplinks:
- Disable:
raycast://ai/settings/disable
- Enable:
raycast://ai/settings/enable
AI Feedback and 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.
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.
We handle this data with the same privacy and security as outlined in our ToS and Privacy Policy.
Usage Limits
Free messages for every user
We provide 50 free messages to any user to give AI a try across Raycast. Every single message you send counts as one. Select from any of the AI models available in our Pro plan. Find your current usage in Raycast Settings. Once you run out of messages, you can upgrade to a Pro plan which comes with a 14-day free trial.
Request limits
To prevent abuse, request limits for Pro plans apply. These limits are shared by all models in their respective group. This is a quickly moving space - we regularly review the limits we offer and reserve the right to update these at any time.
Raycast Pro models:
- 10 requests per minute
- 200 requests per hour
Exception:
- o3-mini: 150 requests per 24 hours
- o4-mini: 150 requests per 24 hours
Advanced AI models:
Same as Pro, plus:
- 75 requests per 3 hours
- 150 requests per 24 hours
Exception:
- o1: 50 requests per week
- o3: 50 requests per week
- o1-preview: 50 requests per week
- o1-mini: 50 requests per 24 hours
More info about all the models and their context limits here.
Note: Context size varies for each model and can be verified in the model selector, which is available in the AI settings and AI Chat.
Note: “Submit Without Generating” does not count towards your request or free message limits.