Relay Shelf 1.2.0 — Markdown reader

Markdown reader

• Open .md and .markdown files in dedicated document windows.
• Set Relay Shelf as the default Markdown viewer from the File menu or document actions.
• Switch between rendered and source views, navigate headings, search with ⌘F, and adjust reading size.
• Refresh automatically after file edits and atomic saves, preserving reading position.
• Follow local Markdown links and heading anchors across windows.
• View local images with deferred, sequential loading and bounded previews.
• Copy source or path, reveal the document, export PDF, open TextEdit, or return to the shelf.
• Recover macOS file access with a native file/folder picker in the reader.
• Use --view from the launcher. Existing shelf import commands continue to work.

Verification

All 11 native test suites passed, including 131 dedicated reader assertions. Frontend validation passed 60 browser assertions with a mocked native bridge. Production packaging, installed-app reading, source view, search, local images, and live refresh were checked on macOS.

Limits

Apple Silicon and macOS 14 or newer are required. Runtime testing used macOS 27.2. This prerelease is ad-hoc signed and unnotarized. Cross-application drag delivery remains a manual verification item.

Markdown input is bounded to 2 MiB with an explicit truncation notice. Full-source copy and PDF export require a complete document. Local image sources are limited to 20 MiB and downsampled. Remote images stay as placeholders and raw HTML is disabled.

The app and source archives include MIT licensing. Download SHA256SUMS.txt alongside both ZIP files to verify them with shasum -a 256 -c SHA256SUMS.txt.

Relay Shelf 1.1.1 — floating file list

Relay Shelf 1.1.1 prerelease

Floating shelves now show multiple items as individual file rows, with a scrollable list for longer collections. Drag a row to take one file, or drag the heading to take the whole group. Successful individual drags keep the remaining items available. Full filenames and paths are available in row tooltips.

The floating window adapts to its contents and keeps its docked edge. Single-item shelves retain their compact layout.

All ten native suites passed. New regression checks cover row order, scrolling, row hit testing and reuse, individual drag retention, and drag-all dismissal. The native list layout was visually verified with sample files.

Cross-application drag delivery still awaits manual verification. This Apple Silicon/macOS 14+ build is ad-hoc signed and unnotarized.

Extract Relay-Shelf-macOS.zip and move Relay Shelf.app into Applications. Download both ZIP assets alongside SHA256SUMS.txt to verify them.

shasum -a 256 -c SHA256SUMS.txt

Relay Shelf 1.1.0 — file actions and automation

Relay Shelf 1.1.0 prerelease

New file workflows

• Save named destination folders and copy selected files into them with collision-safe filenames.
• Capture a region or window using macOS screenshot selection.
• Extract text from images and PDFs using fast on-device Vision OCR with the default English language model.
• Resize, convert and compress images, and strip source image metadata.
• Merge PDFs in a chosen order or create a PDF from images.
• Dock floating shelves at either screen edge and reopen the last floating shelf, including after restart.
• Run an installed macOS Shortcut with selected files and collect its output.

Select files and choose File actions for image, PDF, OCR, destination, and Shortcut workflows. Screenshot capture is also available through the Add menu, command palette, and menu bar.

Responsiveness and storage

Media processing uses system frameworks with sequential background work and bounded decoding. Existing shelf data loads with an empty saved-destination list. Generated media is stored as new app-managed copies. In-flight source protection covers concurrent operations and shelf cleanup.

Docking suspends the 60-second floating-shelf idle timeout. Screenshot capture temporarily hides Relay Shelf windows, then restores their presentation. Escape cancels screenshot selection.

Verification

All ten native test suites passed. Native regression suites cover old-state migration, concurrent destination copies, source retention, ordered PDF output, managed-output cleanup, docking/history, screenshot visibility, media processing, real OCR, and controlled screenshot/Shortcut subprocesses. The media suite passed 249 assertions. Media tests include all eight image orientations, transparency, metadata removal, bounded input failures, and cancellation cleanup.

Live native UI checks passed for image resize and conversion, OCR, metadata removal, image-to-PDF, user-ordered PDF merging, destination management/copying, docking, and installed Shortcut listing. Cross-application drag delivery remains pending manual verification. Screenshot capture needs macOS Screen Recording permission. The installed-app permission-denial guidance was verified. Shortcut execution tests use controlled fixtures.

Download

Requires Apple Silicon and macOS 14 or newer. Runtime testing used macOS 27.2. This app is ad-hoc signed and unnotarized, so macOS may block the download from opening.

Extract Relay-Shelf-macOS.zip and move Relay Shelf.app into Applications. The source archive contains the MIT-licensed source and build instructions. Place both ZIP files beside SHA256SUMS.txt and check them with the following command.

shasum -a 256 -c SHA256SUMS.txt

Relay Shelf 1.0.1 — floating shelf fix

Relay Shelf 1.0.1 prerelease

Floating shelf fix

• Dropped items stay in a compact floating shelf with a file name or item count.
• Drag the captured items out, open the main shelf, or close the floating window.
• Successful drag-out dismisses the floating shelf. Canceled drags keep it available.
• A 60-second idle timeout pauses during hover, active drags, and pending imports.
• Additional drops accumulate, and late import completion respects manual dismissal.
• Captured items remain available in the main shelf after the floating window closes.
• File-promise handling keeps incoming directories protected while providers are writing.

Documentation and verification

The README now covers installation, supported path forms, storage modes, workflows, preview limits, and source development. The public source history and release archives were checked for credentials, private paths, private contact information, and personal files. Public author and license attribution is included.

All seven native test suites passed, including the new floating-shelf lifecycle and import regression checks. The production build and TypeScript checks passed. An isolated native UI check confirmed the loaded floating shelf and its Open shelf action.

Cross-application drag delivery remains pending manual verification. This is an Apple Silicon build targeting macOS 14 or newer and tested on macOS 27.2. It is locally ad-hoc signed and unnotarized, so macOS may block opening the download.

Install

Extract Relay-Shelf-macOS.zip and move Relay Shelf.app into Applications. Source and build instructions are available in the repository and RelayShelf-source.zip.

Place both ZIP assets beside SHA256SUMS.txt to verify the downloads.

shasum -a 256 -c SHA256SUMS.txt

Relay Shelf 1.0.0 — prerelease

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.