Skip to content

maccyplus clipboard

Roy Padina edited this page Oct 7, 2026 · 1 revision

maccyplus-clipboard

You run several Claude sessions at once, plus your own work. Each one prepares a SQL query or a shell command and "copies it to your clipboard". By the time you get to it you can't tell which value came from which session. Each pbcopy also overwrites what you were copying.

This plugin teaches Claude to leave values in your MaccyPlus clipboard history instead. Each value carries a label (the session that produced it) and a note (what it is, where to run it).

Setup

/plugin marketplace add roypadina/padina-claude-code-plugins
/plugin install maccyplus-clipboard@padina

Requires macOS and MaccyPlus 2.8.0+, running (brew install --cask roypadina/tap/maccyplus). Optional: agentctl for readable session-name labels. Without it the label is <folder>·<session id prefix>.

What you get

Feature Mechanism
When and how to leave values, label and note conventions, full command reference skill

No hooks, no agents, no MCP server. The skill triggers when Claude would otherwise copy something for you, or when you ask about your clipboard ("find the query from session X", "pin that clip").

What it looks like

Claude runs:

"$M" history add --label "orders-debug" --note "DataGrip → prod (read-only). Counts orphaned orders." <<'EOF'
SELECT count(*) FROM orders WHERE ...;
EOF

and tells you In MaccyPlus: "orders-debug" — orphan count query (DataGrip, prod). Open MaccyPlus: the value is at the top with an orders-debug chip. Hover to read the note. Type orders-debug in the search to see only that session's values.

Your live clipboard is not touched unless you asked for the value on the clipboard right now (--copy).

Commands Claude can use

list, get, add, update (label/note), pin, unpin, top, copy, delete. There is no clear, on purpose. Full reference: MaccyPlus wiki → Agent clipboard API.

Privacy

The CLI can read your whole clipboard history, like any process running as you could already (pbpaste, the app's database). Claude Code's Bash permission is the gate. The skill tells Claude to read history only for the task at hand, never to store secrets in history, and never to change items it did not add.

Clone this wiki locally