🐦‍⬛ Magpie

Copy freely. Everything is saved.

A fast, searchable clipboard manager for macOS.
Never lose a copy again.

---

The Problem

You have something important on your clipboard. Now you need to copy something else. Do you paste first? Open a scratch file? Panic?

Magpie fixes this. It silently saves everything you copy, so you can always go back and find it. Like a magpie collecting shiny things — nothing is ever lost.

Screenshots

Coming soon — screenshots of the popover, search, and settings.

Features

• Instant search — Find any clip you've ever copied. No more "I know I copied that..."
• Rich content — Text, images, rich text, and file paths are all captured
• Source app tracking — See which app each clip came from, with its icon
• Pin favorites — Keep your most-used clips at the top
• App exclusions — Exclude password managers and other sensitive apps
• Lightweight — Lives in your menu bar, uses SQLite, under 2MB
• Auto-updates — Direct downloads update automatically via Sparkle
• Private — Clipboard history stays on your Mac. Optional anonymous usage metrics, no accounts

Install

Mac App Store

Coming soon

Download (Direct)

1. Download Magpie.dmg from the latest release
2. Open the DMG and drag Magpie to your Applications folder
3. Launch Magpie — it appears in your menu bar (no Dock icon)
4. The direct download version includes automatic updates via Sparkle

Build from Source

git clone https://github.com/Good-Feels/magpie.git
cd magpie
./run.sh

Requires Xcode 15+ and macOS 13+.

Usage

Action	How
Open history	Click the 📋 icon in your menu bar
Search	Just start typing — the search bar auto-focuses
Copy a clip	Click any item (shows "Copied!" then auto-dismisses)
Pin a clip	Right-click → Pin
Delete a clip	Right-click → Delete
Settings	Click the ⚙ gear icon in the popover footer
Quit	Click "Quit" in the popover footer

Tech Stack

• Swift + SwiftUI — Native macOS, no Electron
• SQLite via GRDB — Fast, reliable local storage
• NSStatusItem + NSPopover — Proper menu bar integration
• Sparkle — Auto-updates for direct distribution
• SMAppService — Launch at login (macOS 13+)
• App Sandbox — Mac App Store compatible

Project Structure

├── Package.swift                    # Root package (app executable)
├── ClipboardEngine/                 # Core logic (local Swift package)
│   └── Sources/ClipboardEngine/
│       ├── Models/ClipItem.swift    # Data model
│       ├── Monitoring/              # Clipboard polling + app resolver
│       └── Storage/                 # SQLite via GRDB
├── Magpie/                          # App target
│   ├── App/                         # AppDelegate, AppState, entry point
│   ├── Views/                       # SwiftUI views
│   ├── Services/                    # Launch at login, exclusions, updater
│   └── Magpie.entitlements          # App Sandbox for MAS compatibility
├── run.sh                           # Build & run for development
└── scripts/build-release.sh         # Build signed DMG for distribution

Roadmap

• Global keyboard shortcut to toggle history
• First-launch onboarding and clipboard permission guidance
• Signed/notarized direct release pipeline (DMG + appcast)
• Keyboard navigation (arrow keys + Enter)
• Paste directly into frontmost app
• Sparkle auto-updates (direct download)
• Mac App Store submission
• CLI (magpie list, magpie search, magpie copy)
• Snippets / templates

License

MIT License. See LICENSE for details.

---

Made with ❤️ by Good Feels
Built with OpenAI Codex