Skip to content
Docs
Download

Install

Rays needs macOS 26 or later. It is free and open source under the AGPL-3.0 licence.

  1. Download Rays.dmg. This link always points at the newest version.
  2. Open the DMG and drag Rays to Applications.
  3. Open Rays from Applications.

Rays is not notarized yet, so the first time you open it macOS may say it can’t verify the app. Open System Settings > Privacy & Security, scroll down, and choose Open Anyway. You only do this once.

To use the dl command with a DMG install, link it once:

Terminal window
ln -s /Applications/Rays.app/Contents/MacOS/dl /opt/homebrew/bin/dl
Terminal window
brew install --cask a6n-ai/tap/rays

Homebrew clears the download quarantine, so there is no Gatekeeper step, and it puts dl on your PATH.

Rays checks for a new version each time it opens (at most once an hour) and every 6 hours while it is open. When one is out, a small green note appears at the top of the window; click Download to get it. You can also check by hand in Settings > General > Check for Updates.

With Homebrew:

Terminal window
brew upgrade --cask rays

With Homebrew:

Terminal window
brew uninstall --cask rays # removes the app and stops Rays' sorter helpers
brew uninstall --zap --cask rays # also deletes settings, history and browser helpers

For a DMG install, first open Sorter and choose Remove Sorter… so no folder keeps being sorted, then drag Rays from Applications to the Trash. Your settings and history live in ~/Library/Application Support/Rays; delete that folder to remove them too.