Website: vakovalskii.github.io/copyosity · Download the latest release
A fast, native macOS clipboard manager with on-device intelligence.
Copyosity keeps a searchable history of everything you copy, reads text out of copied images on-device, turns your voice into clean ready-to-paste text, and exposes a command palette for web search and multi-turn agent chat — all from a floating panel you summon with a hotkey. It runs as a menu-bar app and stays out of your way until you need it.
🍎 Apple Silicon and Intel Macs — separate signed DMGs for aarch64 (M-series) and x86_64 (Intel).
Built with Tauri 2, Svelte 5, Rust, and SQLite.
- Screenshots
- Features
- Platform support
- Install
- Keyboard shortcuts
- Privacy
- Build from source
- NeuralDeep hub (optional)
- Development workflow
Clipboard history with search, History / Starred tabs, tag and format filters, and image cards with OCR previews:
More screenshots — overlay layouts, Quick Look, command palette, settings
Starred tab — pinned entries only, same search and filter bar:
Vertical board layout — a single scrolling column instead of the horizontal grid:
Space or ⌘Y on a selected card opens a larger, scrollable preview instead of pasting immediately:
Image entries with recognised text get an Image / Recognised text toggle:
Web search and a multi-turn streaming research agent when NeuralDeep Hub is enabled
(⌘⇧Space, tray menu, or the sparkles button in the overlay):
Web mode — quick lookups without leaving the palette:
Minimize-to-blob — drag the palette out of the way without closing the session:
NeuralDeep Hub settings — one master switch for tagging, transcription, web search, and voice polishing; optional fallback to local Ollama for tagging:
Context-aware voice polishing — hold a shortcut to dictate; the hub LLM cleans the transcription (punctuation, filler, lists) and adapts it to the app you're pasting into:
Quick Menu settings — configurable global hotkey (default ⌘⇧C), collapsible
snippet folders with inline rename; the native Clipy-style menu lists recent
history and saved snippets for two-click paste without opening the overlay:
Local AI settings — step-by-step Ollama onboarding (install / start server / download model / ready):
History settings — resizable overlay size, excluded apps, and clear-history controls with a confirmation dialog:
App permissions overview — Accessibility, Microphone, and Automation status at a glance:
Updates — check for and install new releases, plus a persistent update log for troubleshooting:
General settings — launch at login and interface language (7 locales):
Shipped capabilities, grouped by area:
- Clipboard history — every copy is captured and stored in a local SQLite database, with pinning, custom collections, and full‑text search (including OCR text on images).
- Overlay search & filters —
⌘For/to search; tag bar with format chips (PNG / GIF / JPG) and semantic AI tags; infinite scroll; contextual empty states per filter. - History / Starred tabs — macOS segmented control for pinned vs unpinned entries; custom collection pills with color dots.
- Image clipboard — PNG, JPG, and GIF from the pasteboard or Finder (~20 MB); animated GIFs; format badges; dimensions and file size on cards; OCR preview under thumbnails.
- Quick Look preview —
Spaceor⌘Yon a selected card opens a larger, scrollable preview (full text or image with dimensions/OCR); browse with arrow keys while it stays open; hover the type chip or right-click → Preview for mouse access; animated GIFs play at full resolution. - Resizable overlay — drag the corner grip to resize the panel; width and height persist across reopens; Settings → History → Restore default size resets to the built-in dimensions.
- Vertical board layout — optional single-column scrolling list instead of the horizontal grid.
- Smart paste actions — copy, paste into the frontmost app, and Quick Look without leaving the keyboard — see Keyboard shortcuts.
- On-device image OCR — copied images are run through Apple's Vision
framework (
VNRecognizeTextRequest) so the text inside screenshots and photos becomes searchable. No image ever leaves your Mac for OCR. - Automatic tagging — clipboard entries (and images) are tagged with short, practical labels via NeuralDeep Hub or local Ollama; manual Retag when tagging is ready.
- Local AI option — optional Ollama integration for fully local tagging, with in‑app onboarding (install / start server / download‑model / test states).
- Voice to text — hold a global hotkey to record from any microphone; the audio is transcribed and the result is pasted into whatever app is frontmost. Voice transcription is off by default until you enable it in Settings.
- Context-aware polishing — raw transcription is cleaned into natural, typed‑style text, taking the target app (and optionally a screenshot of the target window) into account so the output fits where it lands.
- Transcripts in history — every voice transcription is saved to clipboard history and written to the pasteboard with retries, so nothing is lost if paste into the target app fails.
- Quick menu — native Clipy-style pop-up at the cursor on a global hotkey
(default
⌘⇧C): recent clipboard history with number keys 1–9, overflow in submenus (up to 100 entries), and saved snippets grouped by folder; pick an item to paste into the app that was frontmost when the menu opened — two clicks, no overlay. - Snippets — reusable text templates (email, address, prompts, …) in folders; edit them in Settings → Quick Menu; they appear in the quick menu for two-click paste; Edit Snippets… in the menu opens that settings pane.
- Command / agent palette — Agent mode is a multi-turn streaming chat
(Vercel AI SDK): bottom textarea (
Entersend /Shift+Enternewline), markdown answers, collapsible tool-call chips (web search, Notes, Reminders, Calendar, screenshot), optional Reasoning blocks, Stop while streaming, voice input, and session history that restores whole conversations. Web mode stays single-shot search. Configurable hotkey (default⌘⇧Spacein Settings → NeuralDeep); in-palette model picker (chat models only); attach a screenshot of the frontmost app; draggable, resizable window with sticky-to-edges, transparency (glass) toggle, and minimize-to-blob.
- App exclusions — native app picker in Settings → History for excluded apps (e.g. password managers); Exclude [App] from the overlay when a sensitive app is frontmost.
- Native macOS actions — the assistant can create Notes, create and list Reminders, and read upcoming Calendar events via AppleScript / Apple Events.
- Menu-bar native UI — runs as a menu-bar app (no Dock icon or Cmd+Tab
entry); a transparent, non‑activating floating panel (
NSPanel) appears over your current app without stealing focus; switching apps dismisses the overlay; global shortcuts summon it when you need it. - Interface language — Settings → General offers 7 languages (English, Русский, Español, 中文, Deutsch, Français, 日本語); applies instantly across the overlay, command palette, and settings.
- Launch at login — optional Settings → General toggle starts Copyosity when you log in (macOS LaunchAgent).
- Auto-updates — checks vkovalskii.com first, then GitHub Releases; downloads signed builds in the background on launch and notifies you when a new version is ready. Settings → Updates offers manual check, Download & install, and an Update log (every step + errors, with Copy/Clear). Copyosity must run from Applications, not the mounted DMG, for in-app install to succeed.
- Privacy — clear unpinned or all history with confirmation; concealed clipboard content is ignored; Copyosity's own copy/paste does not pollute history.
- Accessibility — focus-visible rings, roving keyboard navigation, voice HUD
aria-livebaseline, and support for reduced motion, transparency, and contrast preferences.
| Platform | Status | Install / builds |
|---|---|---|
| 🍎 macOS (Apple Silicon & Intel) | ✅ Supported | Signed, notarized DMGs + *.app.tar.gz updater bundles on Releases |
| 🪟 Windows (x64) | *_x64_en-US.msi and *_x64-setup.exe on the same Releases page; built via windows-build.yml |
|
| 🐧 Linux | ❌ Not supported | No CI builds or releases |
Copyosity is a macOS-native app: NSPanel overlay, pasteboard monitoring,
CGEvent paste injection, Vision OCR, Apple Events, and menu-bar tray behavior
(see macos-tray-menu.md).
On Windows, macOS-only modules compile to inert stubs — the app may install
and launch, but clipboard capture, paste-into-other-apps, OCR, quick menu, and
most integrations do not work. CI also runs build-windows
(cargo check on every PR, continue-on-error) to track compile health.
Do not use Windows builds for daily work until a real port ships.
Linux has no build pipeline; the same stubs would apply if it compiled, but nothing is published or tested.
For automatic clipboard tagging when the hub is off or unavailable:
- Install Ollama
- Open Copyosity Settings → Local AI — follow the step-by-step status panel
- Enable AI tagging; the app can start the server and download the model for you
Expected onboarding states: Ollama not installed → Ollama installed, server not running → Model not installed → Local AI ready.
Downloads are on the latest release page. See CHANGELOG.md for release notes.
Requires macOS 12+ on Apple Silicon (M1 and later) or Intel (x86_64).
| Your Mac | Download |
|---|---|
| Apple Silicon (M1, M2, M3, …) | Copyosity_*_aarch64.dmg |
| Intel | Copyosity_*_x64.dmg |
- Pick the DMG for your architecture (for example
Copyosity_<version>_aarch64.dmgorCopyosity_<version>_x64.dmg, where<version>is the latest release version). - Open the DMG and drag Copyosity into Applications.
- Launch it from Applications (not the mounted disk image — in-app auto-update requires a writable install location). On first run macOS will ask for Accessibility permission (needed to paste into other apps) and, depending on the features you use, Microphone, Automation (Notes/Reminders/Calendar), and screen access.
The build is signed with a Developer ID certificate and notarized + stapled by Apple, so Gatekeeper opens it without warnings (and offline).
macOS will also ask for:
⚠️ Accessibility — needed for paste automation (Cmd+V simulation) and global shortcuts. After rebuilding or reinstalling the app, remove Copyosity from the list and add it again if double-click paste stops working.- Input Monitoring — may be required for reliable hotkey detection
| Format | Download |
|---|---|
| MSI | Copyosity_*_x64_en-US.msi |
| Setup | Copyosity_*_x64-setup.exe |
| Action | What it does | |
|---|---|---|
| 📂 | Cmd + Shift + V |
Open / close clipboard history |
| ⚡ | Cmd + Shift + C |
Open quick menu at cursor (history + snippets) |
| ✨ | Cmd + Shift + Space |
Open command / agent palette (when hub is on) |
| 💬 | Enter in palette |
Send agent message (Shift+Enter = new line) |
| 🔍 | Cmd + F or / |
Focus search in the overlay |
| 👁 | Space or ⌘Y on card |
Quick Look preview (toggle); ⌘Y from search |
| 👁 | Hover type chip · eye | Open Quick Look preview |
| 👁 | Right-click card | Context menu → Preview (Alfred-style) |
| 🎙 | Hold voice shortcut | Record voice (default Option + Space) |
| 📋 | Single click on card | Copy to clipboard |
| 📤 | Double click on card | Paste into active cursor |
| 📤 | Enter on card |
Paste selected entry |
| ✖️ | Escape |
Close Quick Look if open, then clear search, then hide overlay |
| ⬆️ | Cmd + ↑ |
Hide overlay (with or without focus) |
| ⬇️ | ↓ from search |
Leave search and select first visible card |
| ⬅️ | Arrow keys | Navigate cards |
| 📤 | Click paste button | Paste into active cursor |
| ⭐ | Click ★ button | Star / unstar |
| ✨ | Click sparkles button | Open command / agent palette |
| ⚙️ | Click gear icon | Open Settings |
- All data stored locally in
~/Library/Application Support/com.vkovalskii.copyosity/ - AI tagging runs on
127.0.0.1via Ollama — nothing leaves your machine when the hub is off - Exclude sensitive apps in Settings → History, or from the overlay when that app is frontmost
- Clear unpinned or all history anytime from Settings → History
Prerequisites:
git clone <this-repo-url>
cd copyosity
npm install
# run in development (hot reload)
npm run tauri dev
# produce a release bundle (.app + .dmg)
npm run tauri buildThe Tauri config (src-tauri/tauri.conf.json) drives the bundle. The frontend
is SvelteKit (static adapter); the backend is Rust via Tauri 2.
Several cloud‑assisted features — model‑based tagging, web search, the research agent, and transcription / polishing — can be powered by a NeuralDeep hub endpoint. This is entirely optional and disabled until you configure it.
To enable it, open Settings → NeuralDeep and provide:
- your own hub base URL, and
- your own API token (an
sk-...style key).
Turn on the NeuralDeep Hub master switch to enable hub tagging,
transcription, web search, voice polishing, and the ⌘⇧Space agent chat shortcut.
The agent runs a client-side streaming chat loop (Vercel AI SDK) against your hub; tool calls (web search, Notes, Reminders, Calendar, screenshot) execute via Rust on your Mac. Web search mode in the palette uses the same hub credentials.
These credentials are yours: you supply them, and they are stored locally in the app's settings. No tokens, keys, or endpoints are bundled with Copyosity. If you don't configure a hub, the app falls back to local behavior (e.g. local tagging via Ollama and on‑device OCR) where available.
🔒 Privacy note: Never commit your hub URL or token to a repository or share it publicly.
After any code change, run the project checks before committing:
make fix && make check # auto-fix, then full gate (recommended)
# or narrower scopes:
make fix-frontend && make check-frontend
make fix-backend && make check-backendSee CLAUDE.md and AGENTS.md for the full contributor workflow (branching,
commit discipline, and local‑AI onboarding rules).
See docs/architecture/macos-paste-pipeline.md.
make build-macos-intel # Intel Mac .app + DMG → dist/macos/
make build-macos-arm # Apple Silicon (on M-series or cross-target)
make build-macos # Native arch for current Mac
make release-macos-intel # Signed + notarized Intel DMG (Developer ID)
make release-macos # Signed + notarized, native arch
make notarize-info # Check notarization statusArtifacts for local testing land in dist/macos/ (for example Copyosity_<version>_x86_64.dmg, where <version> is the current package.json version).