AI Extensions

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 Quick AI, AI Chat, or Root Search and the AI figures out which tool to call, with what arguments, and runs it for you.

Discover AI Extensions

Built-in AI Extensions

Raycast includes several built-in AI Extensions that work with Raycast itself, the data on your device, and the apps you use on Mac or Windows. The badge next to each one shows the platforms it's available on:

• Apple Health: @apple-health reads your recent activity, workouts, sleep, and other metrics from Apple Health.
• Browser: @browser reads and reasons about the page open in your browser. Requires the Raycast Browser Companion.
• Calculator: @calculator evaluates math, unit and currency conversions, and date calculations.
• Calendar: @calendar asks about your schedule, free slots, or upcoming events.
• Clipboard: @clipboard searches your whole clipboard history by text or category, reads a specific entry, and can replace an entry's text.
• Feedback: @raycast-feedback sends a bug report, feature request, or support question to the Raycast team, and confirms with you before it sends. You can also use the Ask Feedback command in Root Search.
• File Explorer: @file-explorer reads and manages files and folders on your Windows PC.
• File Search: @file-search finds files across your indexed folders.
• Finder: @finder searches and manages files and folders on your Mac.
• Focus: @raycast-focus controls Focus sessions and asks what you're scheduled for.
• Location: @location knows where you are when you ask "what's nearby?". On Windows, the OS asks for permission the first time you run it.
• Manual: @manual answers questions about Raycast straight from the Raycast Manual. You can also use the Ask Manual command in Root Search to jump right into a question, or Open Manual to read the manual in your browser.
• Memory: @memory recalls earlier discussions and decisions from your past AI chats.
• Notes: @raycast-notes creates, reads, and searches your Raycast Notes.
• Quicklinks: @quicklinks creates, searches, and opens your Quicklinks.
• Reminders: @reminders creates, searches, and completes items in Apple Reminders.
• Screen Awareness: @screen-awareness reads the content of the app in front of you, what you have selected, and a screenshot of its window, so you can ask about whatever you're looking at.
• Selected Text: @selected-text pulls in whatever you've highlighted in another app.
• Snippets: @snippets creates, searches, and manages your Snippets.
• 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 using ⌘P / CtrlP to see only the extensions that include tools. 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 analyze both before answering your request.

Permissions

Permissions in Settings → AI → Tools controls whether a tool from an AI Extension, an MCP server, or Raycast itself needs your approval before it runs:

• Ask: Prompts for anything that isn't read-only or covered by an allow rule.
• Auto: The default on paid plans. Raycast reviews each action and only asks when it needs to.
• Always Allow: Runs every tool without asking. Use with caution as this has full permission to your tools and files.

Each chat can override the global setting: open the settings sidebar in AI Chat and change Permissions, or choose Change Permissions… from the Action Panel. Inherited follows the global setting.

What Auto approves

Auto runs safe actions without asking: read-only tools, edits inside the chat's working directory, and everyday shell commands like git status or git commit. It always asks before reading credentials such as .env files or private keys, and before any destructive action.

Steer Auto with Auto-review Rules in Settings → AI → Tools. Each rule pairs an action with Allow automatically or Ask first.

Approve a tool call

When a tool needs approval, the chat pauses and shows a card that describes the action. The description is AI-generated, so check it before you allow. For shell commands, click Show Command to see the exact command.

• Allow: Run the tool this once. Press ↵.
• Always allow: Run it now and skip approval next time. Press ⌘↵ / Ctrl↵.
• Deny: Skip the tool. Press Esc.

When several tool calls are waiting, the Action Panel adds Allow All and Deny All.

Always allow adds the tool to Globally Allowed Tools in Settings → AI → Tools. Select See Allow List there to remove an entry or Reset All to clear the list.

Manage AI Extensions