A native macOS clipboard manager built with Rust and GPUI.

Kopi monitors the system clipboard for new text content and maintains a persistent, searchable history of copied items. Users can organize clips with favorites, rename entries, edit content, and quickly re-copy items to the clipboard.

• Clipboard Monitoring: Automatically captures text copied from any application
• Persistent History: All clipboard entries are stored in a SQLite database
• Favorites: Star important clips for quick access in the Starred section
• Inline Editing: Edit clipboard content directly in the app with auto-save
• Rename Entries: Right-click to rename entries for better organization
• Soft Delete with Undo: Delete items with a 5-second undo window
• Light & Dark Mode: Follows system appearance preferences
• Window Persistence: Remembers window size and position across launches
• Privacy Protection: Automatically excludes content copied from most password managers

Kopi automatically excludes clipboard content from popular password manager applications (1Password, Bitwarden, LastPass, Dashlane, KeePassXC, Keeper) by detecting their pasteboard UTIs.

IMPORTANT API keys, tokens, and other secrets copied from text editors, terminals, or websites are currently stored in Kopi clipboard history. We're exploring options for detecting and excluding these in a useful way, but for now be aware that copying sensitive credentials will create records in Kopi.

When you delete an entry, it's soft-deleted with a 5-second undo window. After that, the entry is hidden from the UI but remains in the database for 24 hours before being permanently removed by a background cleanup task.

To permanently delete all soft-deleted entries immediately, use Kopi → Clear Deleted Items from the menu bar.

1. Download the latest .dmg from Releases
2. Open the DMG and drag Kopi into Applications
3. Before launching, open Terminal and run:

   xattr -cr /Applications/Kopi.app

   This is required because the app is not yet notarized with Apple. macOS will show a "damaged" error without this step.
4. Open Kopi from Applications

• macOS (Intel or Apple Silicon)
• Rust 1.85+ (required for Rust 2024 edition, only needed for building from source)

cargo build --release

The compiled application can be bundled as a macOS app using:

cargo bundle --release

Run with hot-reload during development:

./script/dev

Run tests:

cargo test

Run linting:

./script/lint

Bundle as macOS app:

./script/bundle-mac

Built with:

• Rust for native performance and safety
• GPUI for the user interface (same framework as Zed editor)
• SQLite via rusqlite for data persistence
• arboard for cross-platform clipboard access

Clipboard entries are stored in:

~/Library/Application Support/kopi/kopi.db

Security Note: The database is not encrypted. Anyone with access to your filesystem can read your clipboard history. Do not use Kopi on shared machines where other users have file access.

Kopi excludes clipboard content from password manager applications:

• Content marked as transient or concealed per nspasteboard.org conventions
• Content from password managers (1Password, Bitwarden, LastPass, Dashlane, KeePassXC, Keeper)

Password manager content is never stored in the clipboard history database. Other content, including API keys and secrets, is currently stored.

MIT