Import/export Raycast preferences with GIt history

_Importexport Raycast preferences with GIt history.md

Raycast has a feature to import/export preferences in a .rayconfig file format. This isn't ideal for use in a dotfiles-esque Git repository since it would be difficult to compare changes with a compressed file. Also, unfortunately, syncing is only possible on a pro subscription and only through Raycast's cloud service.

To get a more useful JSON file from the .rayconfig (example shown in example.rayconfig.json), you will have to first have to export a decrypted version. Go to Settings > Extensions > Raycast > Export Settings & Data and under "Export Password," which by default is 12345678, you will want to delete that.

After that, run the "Export Settings & Data" command. You should be able to export all of the preferences (Settings, Extensions, Floating Notes, Script Directories, Snippets) except Quicklinks without setting a password.

Then, in terminal, run gzip --decompress --keep --suffix .rayconfig NAME_OF_FILE.rayconfig and you should get a JSON file similar to example.rayconfig.json.

After that, you can get it back into .rayconfig format using gzip --keep --suffix .rayconfig NAME_OF_FILE and then run "Import Settings & Data" command to get it back.

As for syncing, I am not sure of a way to do it. Deeplinks may be a path but it still requires some input from the user (raycast://extensions/raycast/raycast/export-settings-data and raycast://extensions/raycast/raycast/import-settings-data). Let me know if you have any thoughts

example.rayconfig.json

{
  "builtin_package_typingPractice": {
    "provider_schemaVersion": 1
  },
  "builtin_package_default": {
    "provider_schemaVersion": 1,
    "didMigrateQuicklinkFallbackSearch": true,
    "disabledSiriShortcutIds": [],
    "installedNativeExtensionIdentifiers": ["builtin_package_media"],
    "disabledSiriShortcutNames": [],
    "enabledFallbackSearchIdentifiers": [
      "builtin_command_fileSearch_fallbackSearch",
      "builtin_command_extensionStore_fallbackSearch",
      "builtin_command_searchSnippets_fallbackSearch",
      "raycastQuicklink_9ACA6BC2-5986-429A-965B-79704979028E",
      "builtin_command_dictionary_defineWord_fallbackSearch",
      "builtin_command_translate_fallbackSearch",
      "builtin_command_searchEmoji_fallbackSearch",
      "builtin_command_open-ai-chat-gpt_fallbackSearch",
      "raycastQuicklink_7F5188EF-A84E-4A62-BF17-AF1752169F8B",
      "builtin_command_searchMenuItems_fallbackSearch"
    ],
    "didMigrateWebSearches": true
  },
  "builtin_package_raycastAccount": {
    "provider_schemaVersion": 1
  },
  "builtin_package_floatingNotes": {
    "provider_schemaVersion": 1
  },
  "builtin_package_fileSearch": {
    "provider_schemaVersion": 1
  },
  "builtin_package_github": {
    "provider_schemaVersion": 1
  },
  "builtin_package_quick-ai": {
    "provider_schemaVersion": 1
  },
  "builtin_package_calendar": {
    "provider_schemaVersion": 1
  },
  "builtin_package_dictionary": {
    "provider_schemaVersion": 1
  },
  "builtin_package_scriptCommands": {
    "provider_schemaVersion": 1
  },
  "builtin_package_emoji": {
    "provider_schemaVersion": 1
  },
  "builtin_package_snippets": {
    "snippets": [],
    "provider_schemaVersion": 1
  },
  "builtin_package_raycastExtensions": {
    "provider_schemaVersion": 1,
    "extensions": []
  },
  "builtin_package_navigation": {
    "pinnedMenuItems": [],
    "provider_schemaVersion": 1
  },
  "builtin_package_linear": {
    "provider_schemaVersion": 1
  },
  "raycast_onboarding": {
    "completedTaskIdentifiers": [],
    "provider_schemaVersion": 1,
    "showOnboardingItem": true
  },
  "builtin_package_clipboardHistory": {
    "provider_schemaVersion": 1
  },
  "raycast_version": "1.79.1",
  "builtin_package_webSearches": {
    "provider_schemaVersion": 1
  },
  "builtin_package_browserBookmarks": {
    "provider_schemaVersion": 1
  },
  "builtin_package_url": {
    "provider_schemaVersion": 1
  },
  "builtin_package_reminders": {
    "provider_schemaVersion": 1
  },
  "builtin_package_calculator": {
    "provider_schemaVersion": 1
  },
  "builtin_package_contacts": {
    "provider_schemaVersion": 1
  },
  "builtin_package_asana": {
    "provider_schemaVersion": 1
  },
  "builtin_package_translator": {
    "provider_schemaVersion": 1
  },
  "builtin_package_rootSearch": {
    "rootSearch": [
      {
        "frecencyDate": 749857956.5999999,
        "searchTerms": "export",
        "key": "builtin_command_configurationExport",
        "openedAt": 744105261.879,
        "type": "command"
      }
    ],
    "provider_schemaVersion": 1
  },
  "builtin_package_nodeExtension": {
    "provider_schemaVersion": 1
  },
  "builtin_package_developer": {
    "provider_schemaVersion": 1
  },
  "builtin_package_gSuite": {
    "provider_schemaVersion": 1
  },
  "builtin_package_raycastPreferences": {
    "preferencesAdvanced": {
      "mainWindowCaptureCopyToClipboard": true,
      "navigationCommandStyleIdentifierKey": "macos",
      "mainWindowCaptureOpenQuickAccessOverlay": false,
      "raycastAPIOptions": 0,
      "keepWindowVisibleOnResignKey": false,
      "popToRootTimeout": 90,
      "useHyperKeyIcon": false,
      "mainWindowCaptureShowInFinder": false,
      "raycastWindowPresentationMode": 0
    },
    "preferencesGeneral": {
      "raycastAlternativeEscape": false,
      "raycastGlobalHotkey": "Option-49"
    },
    "preferencesAppearance": {
      "statusBarIsVisible": true,
      "raycastUI_preferredTextSize": "medium",
      "raycastPreferredWindowMode": "default",
      "showFavoritesInCompactMode": true
    },
    "provider_schemaVersion": 1
  },
  "builtin_package_organizations": {
    "provider_schemaVersion": 1
  },
  "raycast_user_activity": {
    "activities": [
      {
        "type": "appOpen",
        "date": "2024-07-31T07:54:16.269Z",
        "id": 1
      },
      {
        "id": 2,
        "type": "openRaycastCommand",
        "infoId": 1,
        "date": "2024-07-31T07:54:21.879Z"
      },
      {
        "type": "appOpen",
        "date": "2024-07-31T07:54:29.432Z",
        "id": 3
      },
      {
        "id": 4,
        "date": "2024-07-31T07:54:35.940Z",
        "type": "appClose"
      },
      {
        "id": 5,
        "type": "appOpen",
        "date": "2024-07-31T07:54:47.765Z"
      },
      {
        "type": "appClose",
        "date": "2024-07-31T07:54:50.017Z",
        "id": 6
      },
      {
        "type": "appOpen",
        "date": "2024-07-31T07:54:54.218Z",
        "id": 7
      },
      {
        "date": "2024-07-31T07:54:58.181Z",
        "id": 8,
        "type": "appClose"
      },
      {
        "date": "2024-07-31T07:55:32.687Z",
        "id": 9,
        "type": "appOpen"
      },
      {
        "id": 10,
        "date": "2024-07-31T07:55:36.659Z",
        "type": "appOpen"
      },
      {
        "type": "appClose",
        "date": "2024-07-31T07:55:39.686Z",
        "id": 11
      },
      {
        "type": "appOpen",
        "date": "2024-07-31T07:55:43.646Z",
        "id": 12
      },
      {
        "type": "appOpen",
        "id": 13,
        "date": "2024-07-31T07:55:46.001Z"
      },
      {
        "type": "appClose",
        "date": "2024-07-31T07:55:51.255Z",
        "id": 14
      },
      {
        "type": "appOpen",
        "id": 15,
        "date": "2024-07-31T07:56:28.785Z"
      },
      {
        "id": 16,
        "type": "appOpen",
        "date": "2024-07-31T07:56:50.962Z"
      },
      {
        "type": "appClose",
        "id": 17,
        "date": "2024-07-31T07:57:29.094Z"
      },
      {
        "date": "2024-07-31T07:57:38.838Z",
        "type": "appOpen",
        "id": 18
      },
      {
        "date": "2024-07-31T07:57:43.118Z",
        "id": 19,
        "type": "appOpen"
      }
    ],
    "activityInfo": [
      {
        "key": "builtin_command_configurationExport",
        "title": "Export Settings & Data",
        "id": 1
      }
    ],
    "provider_schemaVersion": 1,
    "aiChatActivities": []
  },
  "raycast_app_defaults": {
    "firstKnownVersion": "1.79.1",
    "installationDate": "2024-07-31T07:53:51Z",
    "provider_schemaVersion": 1,
    "anonymousId": "9F6FF498-786B-4D66-90A9-15FE0698274D"
  },
  "builtin_package_systemCommands": {
    "provider_schemaVersion": 1
  },
  "builtin_package_jira": {
    "provider_schemaVersion": 1
  },
  "builtin_package_screenshots": {
    "provider_schemaVersion": 1
  },
  "builtin_package_zoom": {
    "provider_schemaVersion": 1
  }
}

Nice one @halo. I found that encrypting the json file isn't required for the import to work (I guess to be backwards compatible before they introduced encryption). You do still need to gzip the file though.