Documentation

The deep versions of these live in the repository and are the source of truth; these pages track them.

Copy/paste workflow

The gesture model, every binding, and how to override them.

CLI reference

`yank`, and how it composes with pbcopy, pbpaste and xclip.

Security model

What the vault protects, what it does not, and the threat model.

Start here

First five minutes

1. Grant Accessibility

macOS asks on first launch. Without it yankd still records everything — it just cannot press ⌘V for you.

2. Copy a few things

Anything you copy anywhere is captured, except from password managers.

3. Paste with one gesture

Hold ⌘⇧ and tap V. Each tap moves down the list. Let go and the selected clip is pasted into whatever you were using. That is the whole interaction.

4. Find the rest

Keep holding for a moment and the searchable palette opens. Or press ⌘⇧F to go straight there.

5. Verify it is encrypted

sqlite3 ~/Library/Application\ Support/ai.dfacto.yankd/yankd.db "select * from clips;" should fail with file is not a database. If it prints your clipboard, something is wrong — tell us.

Full source and docs: github.com/deepakmarathe/yankd