Skip to content

Relay Shelf 1.0.0 — prerelease

Pre-release
Pre-release

Choose a tag to compare

@AryanRG AryanRG released this 07 Nov 12:31
· 5 commits to main since this release

Relay Shelf 1.0.0 prerelease

A local macOS shelf for files, folders, pasted paths, images, links, and text. Swift/AppKit provides native system integration, with a React and shadcn/ui interface hosted in macOS WebKit.

Included

  • Paste quoted, home-relative, absolute, file URL, Markdown-link, and multiple file paths.
  • Preview Markdown, text, JSON, CSV, images, PDFs, and folder contents.
  • Organize named shelves, retain references or independent copies, and undo removals.
  • Capture clipboard content, watch selected folders, and import through the CLI.
  • Copy files into Finder, open originals, use Quick Look, and export ZIPs or rendered PDFs.
  • Open the shelf with ⌘⇧Space or capture the clipboard with ⌘⌥⇧V.

Download and install

Requires an Apple Silicon Mac running macOS 14 or newer.

Download Relay-Shelf-macOS.zip, extract it, and move Relay Shelf.app into Applications. The app is locally ad-hoc signed and has no Developer ID notarization. macOS may block the downloaded app from opening. Source build instructions are included in the README.

RelayShelf-source.zip contains the MIT-licensed source. Third-party components retain their own licenses, and notices are bundled with the application.

Place both ZIP files beside SHA256SUMS.txt and verify them with the following command.

shasum -a 256 -c SHA256SUMS.txt

Verification and known limitations

  • Cross-application drag delivery is implemented and still awaiting manual verification. This release is marked as a prerelease for that reason. Copying files and pasting them into Finder passed a live check.
  • Path resolution passed 427 assertions, and directory monitoring passed 63 assertions. Storage, concurrent import and cleanup, CLI routing, instance locking, and bounded PDF generation passed automated tests.
  • Live checks covered path import, document preview, persistent shelves, native file selection, Finder clipboard delivery, and ZIP and rendered PDF exports.
  • The supplied build targets Apple Silicon. Runtime testing was performed on macOS 27.2.
  • macOS may request access to Documents, Desktop, or Downloads. The native Choose file… action lets you authorize a file or its containing folder. Ad-hoc rebuilds may trigger new permission requests.

Shelf state and captured files are stored locally under ~/Library/Application Support/RelayShelf.