Shelf

A clipboard manager for macOS. Hit Cmd+Shift+V or click the tray icon.

I just didn't feel like this was a thing that should cost money. Now it doesn't anymore.

Preview

What it does

• Monitors your clipboard — text, URLs, images
• Cards show a preview, a title (file path with the filename bolded), and a timestamp
• Re-copying something moves it to the front instead of duplicating it
• Tracks where items were displaced from, so you can peek at old neighbors (click twice - not exactly double click, just... twice.)
• Space bar opens native Quick Look on the selected card
• Arrow keys to navigate, Return to paste, Delete to remove
• Starts on login automatically
• Lives in the menu bar, stays out of your way

Building

Needs Rust and Xcode command line tools.

bash build.sh

App lands in build/Shelf.app.

Installing

bash install.sh

Builds, kills any running instance, drops it into /Applications, opens it.

Debug build

bash debug.sh

Structure

core/       Rust — clipboard monitoring, SQLite storage, FFI exports
bridge/     C header bridging Rust to Swift
src/        Swift — UI, panel, app lifecycle
resources/  Icon SVG, Info.plist

Author

pszsh - My Half-Assed blog. Email: jess@else-if.org