Install On Hand.

On Hand supports Apple silicon and Intel Macs running macOS 14 or later. The app is signed with Developer ID and notarized by Apple.

Install the app

  1. Download On Hand and unzip it.
  2. Move On Hand.app to Applications.
  3. Open On Hand from Applications. Confirm Open if macOS asks whether you want to open an app downloaded from the internet.
  4. Choose “Start keeping my clipboard.” Only new copies are captured.

Install with Homebrew

brew install --cask coreyhaines31/tap/onhand

It installs the same signed app, which keeps itself up to date.

Install from the Terminal

Without Homebrew, this downloads the latest release, checks Apple’s signature, installs it in Applications, and opens it. It stops if On Hand is already installed; installed copies update themselves.

test ! -e "/Applications/On Hand.app" && cd "$(mktemp -d)" \
  && curl -fsSL -o OnHand.zip https://onhandformac.com/download \
  && ditto -x -k OnHand.zip . && spctl --assess --type execute "On Hand.app" \
  && ditto "On Hand.app" "/Applications/On Hand.app" && open -a "On Hand"

Install with a coding agent

Paste this into Claude Code, Codex, or another coding agent. It checks your macOS version, asks before replacing an existing copy, verifies the download, and opens On Hand.

Install On Hand, a free, open-source clipboard manager for Mac (https://github.com/coreyhaines31/onhand).
1. Run `sw_vers -productVersion` and stop if macOS is older than 14.
2. If /Applications/On Hand.app already exists, tell me its version and ask before replacing it.
3. If Homebrew is installed (`command -v brew`), run `brew install --cask coreyhaines31/tap/onhand` (add `--force` when replacing a copy that wasn't installed with Homebrew). Otherwise, in a new temporary folder: download https://onhandformac.com/download with `curl -fsSL -o OnHand.zip`, unzip it with `ditto -x -k OnHand.zip .`, make sure `codesign --verify --deep --strict "On Hand.app"` and `spctl --assess --type execute "On Hand.app"` both pass, then move any existing /Applications/On Hand.app to the Trash and install with `ditto "On Hand.app" "/Applications/On Hand.app"`.
4. Open it with `open -a "On Hand"`.
5. Tell me to click "Start keeping my clipboard" in the window that opens, and that ⌘⇧Space opens my clipboard history from any app.
6. Ask me whether future agent sessions should be able to search my clipboard history, and tell me that anything an agent reads from it goes to its AI provider. Only if I say yes, append this to your own global instructions file (~/.claude/CLAUDE.md for Claude Code, ~/.codex/AGENTS.md for Codex), unless it's already there, and tell me which file you changed:
   On Hand keeps my clipboard history. When I mention something I copied earlier, find it with `onhand search <words>` and read it with `onhand get <id>`. Ask before deleting anything.

Everyday use

Press ⌘⇧Space to open history. Search for a word or app, choose a clip with the arrow keys, and press Return to copy it. Switch to your destination and paste with ⌘V.

Use ⌘1–9 to copy a numbered result, ⌘O to preview, ⌘P to pin, and ⌘F to search. ⌃⌥⌘⌫ forgets your last copy. The full list is under ⋯ › Keyboard Shortcuts.

Turn on ⋯ › Keep Window Open While Switching Apps to reuse several clips across apps. In Settings, you can change the shortcut, choose excluded apps, adjust retention, turn off launch at login, or clear history.

Use it from the command line

The onhand command lets you or an AI agent search history, read a clip, copy it back, or pause capture from Terminal. Homebrew links it for you. If you downloaded the app, link it once:

sudo mkdir -p /usr/local/bin
sudo ln -sf "/Applications/On Hand.app/Contents/MacOS/onhand" /usr/local/bin/onhand

See every command and the line to add to your agent’s instructions.

Build it yourself

View the source on GitHub. Install Xcode, XcodeGen, and SwiftLint, then run make test, make lint, and make app. The built app is in dist/On Hand.app. Full instructions are in the README.