How to Use Raycast: The Beginner's Guide (From Install to Your First AI Command)

CodexFuse Team · 2026-10-29T10:21:39.651Z · 11 min read

Raycast is a keyboard-driven Mac launcher that replaces Spotlight. This beginner's guide covers install, the Spotlight-shortcut takeover, clipboard history, snippets, extensions, AI Commands, and the free-vs-Pro line.

Learning how to use Raycast takes about fifteen minutes, and most of that time is spent on a single decision: handing it your ⌘-Space shortcut. Raycast is a keyboard-driven launcher for macOS that replaces Apple's Spotlight with a faster, extensible command bar — you press a hotkey, type what you want, and it happens. Launching apps, finding files, doing calculations, managing windows, and (on the paid plans) asking an AI a question without leaving the app you are in. This guide walks through installing it, taking over ⌘-Space, the five features worth learning in your first week, and the exact line between the genuinely free tier and the paid Pro plan.

If you live in a terminal and a text editor, Raycast pairs naturally with a keyboard-first terminal — our Warp beginner guide covers the modern terminal side of the same workflow.

What is Raycast, exactly?

Raycast is a free, keyboard-driven productivity launcher for macOS. You press a hotkey (Option+Space by default), type a few letters, and Raycast launches the app, finds the file, runs the calculation, or executes the command — learning your habits as you go, so the things you use most surface after one or two keystrokes. It was founded in London by Thomas Paul Mann and Petr Nikolaev, and the company has raised $47.8 million in funding, so this is an actively developed product with a fast release cadence rather than a side project.

Think of it as Spotlight with the training wheels off: everything Spotlight does, plus clipboard history, text snippets, window management, an extension store with around 2,000 community extensions, and an AI layer — Quick AI, AI Chat, and AI Commands — that sits behind the paid plans.

How do I install Raycast?

Installation takes about two minutes. You need a Mac running macOS 13 or later.

1. Download it from raycast.com (click "Download for Mac") — or, if you use Homebrew, run brew install --cask raycast in your terminal.
2. Grant the permissions it asks for. Accessibility access is what lets Raycast manage windows and drive other apps from the keyboard; the core features do not work without it.
3. Work through the short onboarding. It will ask which hotkey you want. Accept the default Option+Space for now — you will switch it to ⌘-Space in the next step if you decide to replace Spotlight.

A note for Windows users: Raycast shipped a Windows public beta in November 2025, so it is no longer Mac-only — but this guide covers the mature Mac version, which is where the extension ecosystem and the documentation live.

How do I replace Spotlight with Raycast?

This is the step that determines whether Raycast sticks. Do not try to use both Spotlight and Raycast — you will split your muscle memory and never build the habit. Replace Spotlight completely.

1. Disable Spotlight's hotkey. Open System Settings → Keyboard → Keyboard Shortcuts, click "Spotlight" in the sidebar, and uncheck "Show Spotlight search" (⌘-Space).
2. Give ⌘-Space to Raycast. Open Raycast, press ⌘, (comma) to open Preferences, go to General → Raycast Hotkey, click the field, and press ⌘-Space.
3. Test it. Press ⌘-Space, type two letters of an app you use daily, and press Enter. Your fingers already know this shortcut from years of Spotlight — that is the entire point. Zero retraining.

If you ever want Spotlight back, re-check the box in System Settings. Nothing is uninstalled and nothing breaks.

What should I try in my first five minutes?

Open Raycast with your new hotkey and run through these four. They cover most of what the launcher does day to day.

1. Launch an app. Type "chrome" and Google Chrome appears; type "vs" and VS Code appears. Raycast uses partial matching and learns your patterns, so your most-used apps surface after one or two letters.
2. Find a file. Type part of a filename and Raycast searches your Mac instantly. One honest caveat from long-term users: Alfred's file indexing is still faster for deep filesystem searches — Raycast's is more than sufficient for everyday use.
3. Calculate something. Type "250*0.08" for an instant answer, "50 USD to EUR" for live currency conversion, or "10 miles to km" for unit conversion. The standalone Calculator app becomes redundant.
4. Learn the Action Panel. Press ⌘K on any result to see every available action — Open, Quit, Show in Finder, Copy Path on an app; Open, Open With, Move to Trash, Copy on a file. The panel is context-sensitive, and most of Raycast's depth hides behind it.

How does clipboard history work?

Clipboard history is the feature that converts most skeptics. Raycast remembers everything you copy — text, images, links, colors — for three months on the free plan, and you recall any of it with ⌘-Shift-V, then search and paste. The classic use: copy five different pieces of information first, then paste them in any order, instead of copy-paste-switch five times.

Two things to know. First, it is private by design: history is stored locally on your Mac and encrypted, and passwords from password managers are automatically excluded. Second, there is a known limitation with very large text blocks (1,000+ lines), which can be silently truncated — fine for normal work, worth knowing if you copy giant log outputs. Unlimited history and encrypted cloud sync across Macs are Pro features.

What are snippets and Quicklinks?

Snippets expand a short keyword into full text anywhere you type. Set ;sig to expand into your email signature, or build templates with dynamic placeholders: {date} inserts today's date, {clipboard} inserts whatever you just copied. Long-term users report it replacing TextExpander entirely.

Quicklinks turn two characters and a search term into a web action with no browser required. The classic setup: gh {query} searches your GitHub repos, npm {query} searches npm packages, jira {query} searches your Jira board. Create them in Raycast's settings under Quicklinks — each one is just a URL template with a {query} placeholder.

How do I install my first extension?

Extensions are what turn Raycast from a launcher into a command center. Around 2,000 of them live in the Raycast Store — open-source, built with React and TypeScript — covering everything from Spotify controls to Docker management.

1. Open the Store. Press your hotkey, type "store", and press Enter.
2. Install one tool you use daily. Good first picks: Color Picker (click anywhere on screen to grab a hex code), your browser extension, and your code editor extension. Each extension walks you through its own setup, including any API keys it needs.
3. Go deeper when a pain repeats. The heavy hitters for developers are Kill Process (over 415,000 installs — kill hung processes by CPU or memory usage), the VS Code extension (open projects, search recent files), and the Slack extension (set status, search messages). The GitHub and Linear extensions are where the developer workflow really compounds — our GitHub beginner guide and Linear beginner guide cover the tools behind them.

Resist the urge to install thirty extensions on day one. Add one per week as you notice yourself repeating a task in the browser. The Notion beginner guide covers another tool with a first-class Raycast extension.

How does window management work in Raycast?

Raycast has window snapping built in, which lets most users delete a dedicated window manager like Rectangle or Magnet. Type a command like "left half" or "center" and the focused window snaps into place — all from the keyboard, no mouse dragging.

Power users can build multi-window layouts: one command that puts the editor on the left, the terminal bottom-right, and the browser top-right. The built-in presets cover most needs; creating your own custom layouts requires Pro.

What can Raycast AI do, and where is the free-vs-paid line?

Raycast AI is the headline differentiator: generative AI embedded in the command bar instead of a browser tab. Quick AI opens a floating AI window over whatever app you are in — highlight text anywhere and ask it to rewrite, explain, or translate it. AI Chat is a full conversational interface with more than 30 models from OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, and xAI, with file and image attachments. AI Commands are saved, reusable prompts you run with a hotkey. Since version 1.99, Raycast also integrates with Ollama to run open-source models locally on your Mac, and MCP support lets the AI take actions in external tools — "create a GitHub issue for this bug" actually creates it.

Here is the free-vs-paid line, checked against the official pricing page on October 29, 2026 — prices move, so treat this as a snapshot:

Two honest notes. First, some reviews from earlier in 2026 mention 50 free AI messages a month on the free plan — the official pricing page today lists AI as not included on Free, so go by the official page, not the reviews. Second, if you already pay for API access elsewhere, Pro's "bring your own key" option lets you plug in your own Anthropic, OpenAI, Google, or OpenRouter keys instead of paying for Raycast's credits. The free tier is a genuinely complete launcher; you are paying for AI, cloud sync, and unlimited history.

The AI-coding angle pairs naturally with a dedicated coding assistant — see our GitHub Copilot beginner guide for the editor side of the same workflow.

Raycast vs Spotlight vs Alfred — which should I choose?

The honest answer depends on what kind of Mac user you are. Here is the comparison as it stands in late 2026:

Choose Spotlight if you are a casual user — macOS Tahoe added clipboard history and quick keys, and for web-and-email use it is genuinely good enough now. Choose Alfred if you are a long-time Alfred power user with complex workflows, or you want the fastest file search and a one-time purchase instead of a subscription. Choose Raycast if you are starting fresh and want the modern all-in-one: the most built in for free, the biggest extension store, and AI in the command bar.

What beginner mistakes should I avoid?

Four, all common. One: running Spotlight and Raycast on the same hotkey — pick one, fully, or neither becomes a habit. Two: skipping the hotkey takeover and launching Raycast from the Dock — the muscle memory is the product. Three: installing dozens of extensions on day one and then forgetting they exist — add them as you feel a repeated pain. Four: pasting secrets into AI Chat — clipboard history excludes passwords automatically, but anything you hand to a cloud model is data transmitted; for sensitive codebases, the Ollama local-model integration or bring-your-own-key keeps things private.

Sources

• Raycast — official pricing page: plan features and prices, checked October 29, 2026.
• Omer's Blog — "Raycast for Mac Review (2026): An Honest Look": published February 26, 2026, updated July 6, 2026 — daily-use review covering the free tier, clipboard history, window management, snippets, Quicklinks, AI features, extension install counts, the Windows beta, and the Alfred comparison.
• PulseTools — "Raycast Review (2026): Features, Pricing & Verdict": 2026 review with the five-step getting-started path and the Raycast-vs-Alfred-vs-Spotlight comparison.
• Leon Wong on dev.to — "The Beginner's Guide to Raycast: Replace Spotlight in 15 Minutes": published November 7, 2025 — install steps, the Spotlight hotkey takeover, the first-five-minutes walkthrough, and extension setup.

Frequently Asked Questions

Is Raycast really free?

Yes — the launcher, clipboard history (three months), snippets, Quicklinks, window management, calculator, and the full extension store are all free, with no time limit. You only pay if you want Raycast AI, cloud sync across Macs, or unlimited clipboard history, starting at $10 a month for Pro (raycast.com/pricing, checked October 29, 2026).

Does Raycast replace Spotlight, or run alongside it?

It is designed to replace it. Disable Spotlight's ⌘-Space shortcut in System Settings → Keyboard → Keyboard Shortcuts, then assign ⌘-Space to Raycast in its preferences. Running both splits your muscle memory and the habit never forms.

Is there a Windows version of Raycast?

Yes — a Windows public beta shipped in November 2025, and there is an iOS app for AI chat and notes. The Mac version remains the mature one with the full extension ecosystem.

Is Raycast better than Alfred?

For new users, usually yes: more built in for free, a larger extension store, and native AI. Alfred still wins on raw file-search speed, keystroke efficiency, and one-time pricing (around £34 for the Powerpack). If your Alfred workflows already work perfectly, there is no reason to switch.

Is my clipboard data private in Raycast?

On the free plan, clipboard history is stored locally on your Mac and encrypted, and passwords from password managers are excluded automatically. Cloud sync (which transmits data) is a Pro feature, and anything you send to Raycast AI goes to a model provider — for sensitive work, use the Ollama local-model integration or bring your own API key.