Clipurr.
Clipurr keeps a local history of copied text, images and files. Search finds earlier copies, including text recognized in images.
Search the history.
Search for React to find the image, or pin an item to keep it at the top.
- Review the API contract · Workshop notes · project-notes.md
Review the API contract
Browser demo with sample data and pre-filled OCR text. Changes stay in memory; your clipboard is not accessed.
Go back to an earlier copy.
A new copy usually replaces the previous one. Clipurr keeps text, images and file references in a searchable list. You select an item and copy it again.
How content moves through the app.
Capture
ClipboardMonitor watches NSPasteboard changes. ContentTypeExtractor identifies text, images or file references.
Store
HistoryStore removes duplicates. PersistenceManager saves the history to a local JSON file.
Find
OCRService runs Apple Vision in an actor. The recognized text stays attached to the item and can be found through search.
Re-copy
The list uses SwiftUI and the popover uses AppKit. Copying again can preserve RTF/HTML representations or use plain text.
Find an image by what it says.
Recognition runs outside the UI. The image appears in the list before Vision finishes; the result is then attached to the item by its identifier. If OCR fails, the app keeps the item and returns empty text for search.
Pinned items stay at the top and survive automatic cleanup by count or age. You can still delete them manually. When the app copies an item again, it tells the monitor the write is its own to avoid adding another entry.
History on the Mac.
The history is stored in a local JSON file. Apple Vision recognizes text in images on the Mac, so the image contents can be found through the same search as copied text.

