Repository navigation
Relay Shelf 1.0.0 — prerelease
Pre-releaseRelay 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.txtVerification 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.