Browse the handbook

Clipboard history

Cleat keeps every text, image and file you copy in a local database with its source app, and pastes back into the window you came from. Password managers are skipped.

Cleat toolsUpdated

Press ⌘ ⇧ V, or type clip in the palette. Cleat has been recording everything you copied since it launched: text, images and files, with the app it came from and when.

Searching

Type to filter. Text entries match on their content, files on their name. The subtitle shows the source app, how long ago, and the size.

Pasting

Return pastes the entry into the window you were in before you opened Cleat, by putting it on the clipboard and pressing ⌘ V there. That needs Accessibility access; without it, Return copies and you paste yourself. ⌘ ⏎ copies without pasting. ⌘ ⌫ with an empty search field deletes the selected entry.

Transforms

The root palette lists clipboard transforms as commands: paste as plain text, uppercase, lowercase, title case, trimmed, pretty JSON, minified JSON, and slug. Each one changes the current clipboard and pasts the result.

What is skipped

Copies from password managers and anything an app marks as concealed or transient are never recorded. This uses the pasteboard types those apps set, so 1Password, Bitwarden, Keychain and similar are covered without a list to maintain.

Where it lives

~/Library/Application Support/Cleat/cleat.sqlite holds text and file entries. Images are stored next to it in images/. Settings › General shows the count and has a button to clear everything.

Importing

Alfred’s clipboard history can be imported from the palette with Import from Alfred. See Import from Alfred or Raycast.

How much is kept

Settings › General › Clipboard has Keep at most, 1,000 items by default, from 50 up to 10,000. The oldest entries and their images go when the cap is passed. Clearing the history is the button next to it.

Pins and image text

⌘K on any entry offers Pin to Top. A pinned entry stays first in the list, shows “Pinned”, and is never trimmed when history reaches its limit. Unpin from the same menu.

Copied images are read for text on your Mac, so a screenshot of an error message or an invoice is found by typing a word from it. The text shows after the image size. Settings › Search has the switch.

The preview pane

The right-hand pane shows the whole entry: text with a character and line count, an image at full size with any recognised text, or a file list with icons, plus the app it came from. Edit Before Pasting opens the text for changes; Paste Edited sends the fixed version.

Hygiene

Settings › Clipboard & Snippets can forget items after a number of days (pinned items stay), exclude apps you copy secrets from, and export the history as JSON.

While the screen is locked

Nothing is recorded between the lock screen and the unlock, and Exclude Installed Terminals in Settings › Clipboard & Snippets adds Terminal, iTerm, Ghostty and the others that are installed to the never-record list in one click.

Filters

In the clipboard history, kind:image, kind:link, kind:file and kind:text keep one kind, pinned keeps pinned entries, and from:safari keeps what was copied in one app. Anything else on the line searches the text as before, so kind:link github is the GitHub links you copied.