Settings

Settings is where you personalize Raycast to fit your workflow. From appearance and hotkeys to AI configuration and extension management, everything is accessible from a single, streamlined interface. In v2, Settings has been redesigned with a cleaner layout that matches the refreshed look and feel of the app.

Opening Settings

There are several ways to access Settings:

• Type Settings in Root Search.
• Press ⌘ / Ctrl , when Raycast is open.
• Select any command in Root Search, open the Action Panel (⌘ / Ctrl K), and choose Configure Command or Configure Extension.
• Press ⌘ / Ctrl ⇧ , from Root Search to jump directly to the selected item's settings.

Account

The Account tab sits at the top left of Settings and shows your profile at a glance. Simply click on your display name to manage your Raycast account, view your current plan (Free, Pro, or Teams), and access subscription settings. You can also sign in or sign out of your account, and switch between organizations if you belong to more than one.

General

The General tab contains the core options that shape your everyday Raycast experience.

Open at Login

Choose whether Raycast launches automatically at login. We recommend keeping this enabled so Raycast is always ready when you need it.

Show in Menu Bar

Toggle whether Raycast appears in the menu bar. When enabled, you can quickly access Raycast settings, check for updates, and quit the app from the menu bar icon.

Raycast Hotkey

Set the global keyboard shortcut that opens Raycast from anywhere on your computer. The default is ⌥ / Alt Space. On macOS, you can replace Spotlight by assigning ⌘ Space to Raycast for an even more seamless experience.

Appearance

Control the visual presentation of Raycast.

Follow System Appearance

Raycast adopts your system's light or dark mode by default. Toggle this off to manually choose a theme. Raycast ships with a curated set of built-in themes, and you can browse and install community themes from the Store.

Window Mode

Choose between Compact and Expanded mode. Compact mode uses a more condensed layout so you can see more results at a glance.

Launcher

The top of the Launcher tab is where you fine-tune the everyday launcher behavior.

Set which screen Raycast opens on, how it pops to root search after sitting idle, and dial Root Search to surface more results or only the closest matches.

Customize Search

Choose whether to inclue Files and Contacts in Root Search, alongside your apps, commands, and extensions.

Fallback Commands

New Configure which commands appear at the bottom of Root Search results when your query has no matches. Add commands from any extensions, use to reorder them, and use to remove ones you don't want.

Shortcuts

New The Shortcuts tab gives you a bird's-eye view of every shortcut assigned across Raycast. You can filter by category and see which commands already have hotkeys or aliases. This is the central place to manage all your shortcuts at a glance, rather than navigating into individual extension tabs.

You can also assign shortcuts from each extension's dedicated tab in Settings, or directly from the Action Panel in Root Search.

New You can now assign hotkeys and aliases directly from the Action Panel in Root Search, no need to open Settings first.

New The hotkey recorder has been completely rebuilt with support for single-tap fn key on macOS and Win on Windows as a modifier, improved conflict detection, and the ability to overwrite conflicting shortcuts.

New You can now assign left and right modifier keys as hotkeys. Simply click on the key when you set it up in Raycast Settings > Shortcuts

Keyboard

The Keyboard tab lets you customize how you navigate within Raycast using your keyboard.

Emacs & Vim Key Bindings

Enable Emacs-style (Ctrl N / Ctrl P) or Vim-style navigation for moving through lists and text fields within Raycast.

Navigation

Fine-tune search and navigation behavior, such as whether pressing Esc returns to Root Search or closes Raycast entirely.

Advanced

The Advanced tab provides additional configuration for power users.

Window Behavior

Configure how the Raycast window behaves:

• Auto-close on focus lost: choose whether Raycast hides when you click away
• Return to Root Search: set when Raycast resets to the main search view (immediately, after a delay, or never)
• Window position on multi-monitor setups: Raycast opens on the display that currently has keyboard focus

Export & Import Settings

Export your full Raycast configuration to a file and import it on another machine. This transfers your extensions, hotkeys, aliases, and preferences so you can set up a new machine quickly.

HTTP Proxy

If your network requires a proxy, configure it here. Raycast will route its network traffic through the specified proxy server.

Organizations

If you are part of a Raycast Teams plan, the Organizations tab lets you view and manage your team membership. You can see which organization you belong to, switch between organizations, and access team-specific settings and policies configured by your admin.

About

The About tab shows your current Raycast version number, provides links to the Raycast website and changelog, and lets you submit feedback or bug reports. You can also check for updates here.

AI

The AI settings are where you configure how Raycast AI works for you — agents, commands, extensions, memory, and the general behavior of AI Chat and Quick AI. Toggle the switch in the top right to enable or disable AI globally.

Agents, AI Commands & AI Extensions

Three sub-panes manage everything you can build on top of AI:

• Agents — your custom AI agents, each with their own instructions, tools, and personality.
• AI Commands — reusable prompts you can trigger anywhere in Raycast (translate, summarize, fix grammar, etc.).
• AI Extensions — extensions that AI can call as tools when answering you, letting it take real actions across your apps.

Personalization

Profile

Add context you want available in every conversation — your role, the tools you use, how you'd like AI to respond. The profile applies to AI Chat and Quick AI, but not to AI Commands (which run with their own dedicated prompts).

Memory

When Memory is on, Raycast keeps a running summary of details from your conversations and reuses them automatically. Just tell it what to remember in any chat — for example, "Remember I'm vegetarian."

Use Show Memory to review or edit what's stored, or Import to bring in memory from another source.

General

• Start New Chat — how long Quick AI waits before starting a fresh conversation when you reopen it. Default is After 5 minutes.
• Send Message — the keyboard shortcut used to send messages in AI Chat. Default is ⌘ Return.
• Conversation History — choose whether AI Chat and Quick AI conversations live in a combined history or stay Separate.
• Auto-Archive Chats — automatically archive chats after a period of inactivity. Default is Never.

API Keys

Bring your own API keys (OpenAI, Anthropic, etc.) to use AI at your own cost. When a key is set, Raycast routes requests through your provider and you pay their standard rates directly.

Commands

The AI extension ships with a full set of built-in commands you can alias, hotkey, or disable individually

Applications

The Applications settings let you fine-tune how Raycast finds, launches, and manages your installed apps. Toggle the switch in the top right to enable or disable Applications globally.

Auto Quit

Open Auto Quit to have Raycast automatically close apps shortly after you stop using them, freeing up memory without you having to think about it.

Hotkey Action

Choose what happens when you press an application's hotkey. The default, Toggle Visibility, brings the app to the front if it's hidden and hides it again on the next press.

Search Scopes

Use the + button to add extra folders so apps stored outside the standard locations show up in Raycast too.

Per-App Configuration

Use the search field to find any installed app, then configure it inline:

• Add Alias — give an app a custom name to type (for example, "music" for Spotify).
• Record Hotkey — assign a global keyboard shortcut to launch or toggle the app.
• Checkbox — disable individual apps you don't want to appear in Raycast's results.

Commands

The Applications extension also ships with built-in commands you can alias, hotkey, or disable like any other:

• Uninstall Applications — quickly remove installed apps directly from Raycast

Extensions

Below the list of Applications, each installed extension appears as its own entry in the sidebar. Select any extension to manage its preferences, authenticate with third-party services, enter access tokens, and assign shortcuts to its commands.

Browsing Extensions

Extensions are grouped into categories in the left sidebar: Built-in commands, Store extensions, Script Commands, and Quicklinks. Select any extension to see its commands and settings.

Enabling & Disabling Commands

Each command has a toggle to enable or disable it. Disabled commands won't appear in Root Search. This is useful for hiding commands you don't use to keep your search results clean.

Extension-Specific Settings

Many extensions expose their own configuration options. For example, a Jira extension might ask you to log in, or a GitHub extension might let you choose a default repository. These settings appear when you select the extension in the sidebar.

Uninstalling Extensions

To remove a Store extension, select it in the sidebar and click the Uninstall button, or right-click the extension and choose Uninstall.