Skip to content
Account

Cloud Sync

ProAlpha

Cloud Sync is currently in alpha and available to Raycast Pro subscribers. Availability may be limited while it rolls out. Available in Raycast for Mac (both the v1 and v2 apps), Raycast for Windows, and Raycast for iOS.

Getting Started

Before turning on Cloud Sync, run the Export Settings & Data command to create a backup of your current setup. This makes sure you have a safe copy of your data to restore from in case anything goes wrong during the initial sync.

  1. Join the Cloud Sync Alpha channel

    Join our Raycast Slack Community and make sure you are part of the Cloud Sync Alpha channel. If you are not part of the channel, please DM @David or @Tirta.

    Please don't post anything about it publicly, including on social media. Keep all discussion within this group for now.

  2. Migrate from Raycast v1

    If you're a macOS v2 user and haven't run the Migrate from Raycast v1 command, please do so. Ignore this if you're a Raycast Windows user or a macOS v2 user with your app already set up.

  3. Back Up Your Data

    Run the Export Settings & Data command to create a backup of your current setup. We also recommend enabling scheduled Export Settings & Data so you always have a recent backup.

  4. Sign In to Your Raycast Account

    Make sure you're signed in to your Raycast account in Raycast Settings → Account (a Pro subscription is required).

  5. Open the Cloud Sync Sidebar

    Open Raycast Settings (⌘ / Ctrl ,), then go to the Cloud Sync sidebar.

  6. Turn Cloud Sync On

    Use the toggle in the top-right corner to enable or disable the Cloud Sync feature entirely. Once enabled, choose which categories you want to keep in sync.

Cloud Sync requires a signed-in Raycast Pro account. If you sign out or your session expires, syncing pauses and resumes automatically once you sign back in.

The Cloud Sync settings tab with the enable toggle turned off and the alpha backup reminder

Overview

Cloud Sync keeps your Raycast data consistent across all your devices and apps. Once enabled, the things you create and customize in Raycast (Quicklinks, Snippets, Notes, AI chats and presets, themes, window layouts, and more) are stored in the cloud and automatically kept up to date everywhere you are signed in. It syncs across the Raycast for Mac v1 and v2 apps, the Raycast for Windows app, and the Raycast for iOS app, so a change you make in one app shows up in all the others, without manual exports or backups.

Cloud Sync runs continuously in the background. Changes are captured locally and replicated through Raycast's sync service, so your devices stay in sync even after being offline. You choose which categories of data to sync and can turn each on or off at any time.

The Cloud Sync settings tab with sync enabled, showing Synced Devices, Synced Content, and the items that are not synced

What Syncs

In the Cloud Sync settings, the Synced Content screen is where you control what's kept in sync. Each row shows a live count of how many items are currently synced and a toggle to turn that category on or off. The categories include:

  • AI Commands & Agents
  • AI chat history
  • MCP servers
  • Quicklinks
  • Snippets
  • Raycast Notes
  • Window management layouts
  • Themes
  • General Settings (Open at Login, Show in Menu Bar, Appearance, and Window Mode)
  • Extensions (settings, commands, and hotkeys)

Some preferences are synced by default and can't be turned off, such as Other General Settings and Root Search Ranking. AI Chat History also always keeps the AI models and folders it depends on in sync, even if you turn off AI Commands & Agents.

The Synced Content screen listing each category with its item count and sync toggle

Not Synced

  • Clipboard History
  • Screenshots
  • Search Ranking
  • Search History
  • Window Activation Behavior
  • Export / Backup Settings (Export Passphrase, Scheduled Backup, Backup Location, Auto-Delete)
  • Script Commands (scripts only; their settings sync)
  • Credentials & Passwords

Managing Your Devices

The Cloud Sync settings show every device connected to your account. From there you can:

  • Rename a device so it's easy to recognize.
  • Deauthorize a device with v2 app to stop it from syncing and revoke its access. The next time that device starts, it stops syncing and clears its local synced state.

The Synced Devices screen lists every device connected to your account. Each entry shows the device name, platform, app version, and when it last synced. Your current device is marked This Device, and you can remove any other device with the ✕ button next to it.

Legacy Raycast Devices groups together all of your v1 devices in a single entry (your macOS v1 and iOS Cloud Sync). You can't enable or disable individual v1 devices from here. The Cloud Sync settings shown here are exclusively part of v2, and Cloud Sync v2 for iOS is coming soon.

The Synced Devices screen listing each connected device with its platform, app version, and last sync time

Turning Cloud Sync Off

Turning Cloud Sync off on a device stops data from syncing. Any data previously synced to that device will remain on it, and your data will stay available in the cloud and on other synced devices.

Privacy & Security

Synced data is tied to your Raycast account and is encrypted on your local device DB, in transit, and on the server's DB.

FAQ

How to Give Feedback

Cloud Sync is in alpha, so your feedback is especially valuable. Please report bugs and share suggestions in the Cloud Sync feedback channel in the Raycast Slack Community. For access to the private channel, please DM @David or @Tirta.

Please don't post anything about it publicly, including on social media. Keep all discussion within this group for now.

For most issues, sharing your Raycast logs with us is also incredibly helpful. We have a couple of commands to make it easy for you to access them.

  • Copy Raycast Logs — Copies your latest two log files to the clipboard
  • Reveal Raycast Logs — Open your log folder for you to find all of your logs.

Where to Focus Your Testing and Feedback

Our top priority right now is fixing bugs and addressing performance issues. Once this is stable, we will focus on closing feature parity gaps and then work on improvements and new features in this version.

As you try Cloud Sync and test it for us, please keep these priorities in mind and, as much as possible, please help us focus on bugs and performance. Also, if you notice small things that are missing but would be useful to you, please let us know; that feedback is very helpful.

Feedback Format

When sharing feedback with us in Slack, please aim to follow the following two suggestions to help us triage these issues with you:

  • Share one bit of feedback per message so that it is easier to collaborate with you on it. Or at least group feedback per feature in one message where possible.
  • Please prefix these messages with either [BUG] or [FEATURE].