# AI Extensions

> Platforms: Mac

AI Extensions empower Raycast AI to perform actions and automate workflows within your extensions, allowing you to accomplish more simply by asking.

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.

<YouTube videoId="sHIlFKKaq0A" title="AI Extensions in Raycast" />

## 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 (`Cmd` `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.


---

## Need Help?

Contact Raycast Support if you have any questions or would like help with AI Extensions. Use the **Send Feedback** command directly in Raycast to report bugs and billing issues, log feature requests, or any other queries you would like to speak to us about.

You can view all Raycast Support contact options at https://manual.raycast.com/contact-support
