Documentation

Clipboard

Automatic clipboard history (text, images, files) with OCR and deduplication.

Copy anything, anywhere. It appears in the Stream by the time you open Gisti.

What gets captured

  • Text: plain and rich, with the source app recorded. Copied URLs are captured as plain text like anything else; there’s no separate link type.
  • Images: copied images and screenshots; OCR runs automatically, so image text is searchable.
  • Files: copy one or more files or folders in Finder; their path(s) are saved as a clip, titled with the filename (or a count like “2 folders, 3 files” for multiple).

How it behaves

  • The clipboard is polled 5 times a second (interval configurable in advanced.yaml).
  • Deduplication by content hash: copying the same thing twice moves one element up instead of creating a second one.
  • History limit: set the maximum number of clips in Settings → Clipboard; the oldest fall off quietly. Favorites survive cleanup. Copied images count against the separate images limit (Settings → Screenshots → Max images), not the clipboard one.
  • Source app is stored with every clip, and you can open the app it came from ( O).

Ignored apps

Add password managers and anything sensitive to Settings → Clipboard → Ignored apps. Gisti skips their copies entirely – nothing is stored, not even briefly. The picker lists every app installed on your Mac, not just ones that have already copied something.