Repository navigation
Home
A clipboard manager that acts on what you copy. MaccyPlus is a fork of Maccy, the lightweight macOS clipboard manager, with an automation layer on top: rules, actions, plugins and a headless config CLI. macOS only.
brew install --cask roypadina/tap/maccyplusMaccyPlus keeps everything Maccy does (searchable history, keyboard-first, native UI, private) and adds:
- Rules with conditions (URL, email, phone, file path, color hex, image, text, regex, contains-text, source app, soft-wrapped, from a terminal) that match what you copied.
- Actions that do something with it: open as URL, open in an app, web search, reveal in Finder, open a file, transform text, run a macOS Shortcut.
- Per-action shortcuts and auto-run on copy.
- Plugins (declarative JSON or sandboxed JavaScript) with a marketplace.
- A headless CLI to manage all of it from scripts or AI coding agents.
- An agent clipboard API: AI agents leave values in your history with a label (which session) and a note (where to run it), shown on the row and matched by search.
Upstream Maccy is a separate project; see Credits.
- Installation: Homebrew, release zip, first launch (not notarized), build from source.
- Usage: popup, search, paste, pin, clear, ignore.
- Actions and Rules: conditions, builtin actions, per-action shortcuts.
- Plugins: declarative and JavaScript engines, local folders, marketplace.
-
Command line:
MaccyPlus rules add|update|listand friends. -
Agent clipboard API:
MaccyPlus history …, labels and notes, the Claude Code plugin. - Permissions: Accessibility, Finder Apple Events.
- Troubleshooting
- FAQ
- Credits
- Feature requests and contributing: how to ask, supporters first, PR rules.
Requires macOS 14 Sonoma or later · Apple Silicon and Intel (universal binary).
If MaccyPlus saves you time with your clipboard, you can support its development. It is optional and always appreciated.
Once in a while, MaccyPlus asks too (since 2.11.0). A small receipt card shows up about 20 seconds after you pick an item from the history (copy or paste), or a rule action runs, while you are still at the Mac. It only appears after more than 60 picks from the history, and at most 3 times a year. "Ask me in 2 weeks" snoozes it, and "Nope, don't ask again" keeps it away until the next major version. If you open the history popup, a MaccyPlus window or an update prompt while the card is still open, it closes and counts as a snooze; one left unanswered for 5 minutes, or when you step away (2 minutes without input, sleep or screen lock), fades and counts as a snooze too. It never takes keyboard focus, and its counts stay on your Mac. Hold ⌥ in the right-click menu for Show Support Prompt Now to preview it.
