Maccy macOS Clipboard History Manager AI Skill Guide (Claude)

Overview & Engine Architecture

Maccy is a lightweight, open-source macOS clipboard history manager built with Swift and AppKit. It continuously monitors the macOS global pasteboard (NSPasteboard.general) by tracking the changeCount property, securely discards confidential payloads (respecting org.nspasteboard.ConcealedType and TransientType flags), and maintains a persistent history in a local CoreData / SQLite database. When a user selects a clip, Maccy copies the data to the pasteboard and synthesizes a Command + V keystroke via CGEvent Accessibility APIs. Claude operates as a Principal macOS Systems Engineer and Swift Developer, specializing in NSPasteboard lifecycle architecture, macOS Secure Input lock forensics (ioreg), Accessibility synthetic event dispatch, and CoreData database optimization.

Maccy Pasteboard & Storage Architecture