Relay

Open every link in the right browser profile.

Website · Releases · Contributing ·

Relay is an open-source macOS link router for Google Chrome, Microsoft Edge, and Firefox. It turns browser profiles into spaces such as Personal and Work, then routes links by domain or asks you to choose a destination.

Status: Relay is pre-1.0. Signed and notarized builds are available from GitHub Releases.

Install

Relay requires macOS 13 or later and a local Chrome, Edge, or Firefox profile. Download Relay-<version>.zip from GitHub Releases, move Relay.app to Applications, and launch it.

Get started

1. Let Relay discover your browser profiles.
2. Add profiles as spaces such as Personal or Work.
3. Add domain rules and, optionally, select a fallback space.
4. Set Relay as the default browser.

The most specific domain rule wins. Without a matching rule or fallback, Relay asks where to open the link and can remember the choice for that domain.

Command-line tool

Install the bundled relay executable from the app's Command Line Tool panel. It is managed at ~/.local/bin/relay without administrator access or shell configuration changes.

relay profiles
relay resolve https://docs.example.com
relay open https://example.com --context Work
relay doctor

Use --json with profiles or resolve for machine-readable output. The CLI reads the app configuration but does not modify configuration or history.

Privacy

Relay stores its configuration locally and contains no analytics or telemetry. Routing history records normalized domains and outcomes, never URL paths, queries, fragments, or page content. Relay handles HTTP and HTTPS links only.

Development

Relay requires Xcode with a Swift 6 toolchain. Clone the repository and open Relay.xcodeproj, or run the test suites directly:

swift test --package-path Core
xcodebuild \
  -project Relay.xcodeproj \
  -scheme Relay \
  -configuration Debug \
  -destination 'platform=macOS' \
  test

The native app lives in App/Relay/, the reusable core and CLI in Core/, and the landing page in website/. See CONTRIBUTING.md for development guidelines, website/README.md for website development, and docs/RELEASING.md for releases.

Report security issues privately by following SECURITY.md.

License

MIT