Install
Rays needs macOS 26 or later. It is free and open source under the AGPL-3.0 licence.
- Download Rays.dmg. This link always points at the newest version.
- Open the DMG and drag Rays to Applications.
- 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:
ln -s /Applications/Rays.app/Contents/MacOS/dl /opt/homebrew/bin/dlHomebrew
Section titled “Homebrew”brew install --cask a6n-ai/tap/raysHomebrew clears the download quarantine, so there is no Gatekeeper step, and it puts dl on your PATH.
Update
Section titled “Update”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:
brew upgrade --cask raysUninstall
Section titled “Uninstall”With Homebrew:
brew uninstall --cask rays # removes the app and stops Rays' sorter helpersbrew uninstall --zap --cask rays # also deletes settings, history and browser helpersFor 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.