A native macOS menu bar app that automatically organizes your Downloads folder. Built entirely in Swift and SwiftUI — no Python, no Electron.

Features

• Auto-classify — watches your Downloads folder and sorts files into subfolders automatically
• Smart rules — match by file extension, keyword, or date (older than X days, newer than X weeks, etc.)
• Auto-rename — add date prefixes, lowercase filenames, replace spaces, add custom prefixes/suffixes
• Move to Trash — rules can trash files instead of sorting them (great for old installers)
• TF-IDF search — fast full-text search across all your organized files
• History mode — see every move Shelve has made, with one-click undo
• Setup wizard — first-launch onboarding to get you configured in seconds
• Liquid Glass UI — native macOS 26 design language throughout

Getting Started

Requirements

• macOS 26+
• Xcode 16+

Run in Xcode

1. Clone the repo and open the shelve-native folder in Xcode (it detects Package.swift automatically)
2. Set the scheme to Shelve and destination to My Mac
3. Hit ⌘R

Build a distributable .app

# After building in Xcode (⌘B):
./build-app.sh

Drag Shelve.app to /Applications.

Keyboard Shortcuts

How Rules Work

Each rule has:

• Extensions — e.g. .pdf, .docx
• Keywords — matched against the filename
• Date conditions — e.g. "modified older than 30 days"
• Rename steps — applied in order before moving
• Move to Trash — trashes the file instead of sorting it

A file is moved if it matches an extension or keyword or any date condition. Rules are fully editable in Settings → Rules.

Config

Stored at ~/Library/Application Support/Shelve/config.json. Editable via the Settings window (menu bar icon → Settings).

Project Structure