Docs

Shortcuts, rules, permissions

Everything is reachable from the keyboard.

Shortcuts

⇧⌘VOpen or close the panel (global)
↑ ↓Move selection
⌘↵Paste the selected item
⇧⌘↵Paste as plain text
⌘1 … ⌘9Quick-paste one of the first nine items
⌘KActions: transforms for the selected item
↵ / ⌥↵In Actions: transform and paste / transform and copy only
⌥ (hold)Reveal a redacted secret
⌘⌫Delete the selected item (destroys a secret now)
⌘PPin or unpin
⌘⌥1 … 7Switch type filter (All, Text, Code, Link, Image, File, Guarded)
⌘,Settings
escClose Actions, then the panel

Global shortcut is configurable in Settings → Shortcuts.

Search

Type to search text, pinyin (full or initials) and source app names. Prefixes narrow it down: type:json, app:Xcode, is:secret.

How secret rules work

Every copy passes through the same checks, in order. The first match decides what happens. All of it runs on your Mac, in under a couple of milliseconds, on the first 64 KB.

  1. Concealed or transient flag. Items a password manager marks with org.nspasteboard.ConcealedType, TransientType or AutoGeneratedType are not recorded.
  2. Excluded apps. Anything copied from an app on your exclusion list (1Password, Bitwarden, Keychain Access and similar by default) is not recorded.
  3. Secret scanner. Built-in rules recognise AWS keys, GitHub tokens, OpenAI / Anthropic keys, Stripe, Slack, Google API keys, JWTs, private keys and database URLs with passwords. A hit is stored as a secret item.
  4. Everything else. Saved normally, de-duplicated, searchable.

What a secret hit does

  • Drop (default). Shown redacted, destroyed after 30 seconds. Never added to the search index. Deleted data is overwritten.
  • Mask. Kept, but always shown redacted until you hold ⌥.
  • Off. Rule disabled for that category.

Rules are written to avoid false alarms: a plain UUID or a Git commit SHA is not treated as a key. If something is wrongly caught, you can switch that rule to Mask or Off in Settings → Privacy & Guard.

The rule tester in Settings → Privacy & Guard lets you paste a string and see which rule matches. What you type there is never stored or logged.

Permission troubleshooting

Menu and setting names can vary slightly between macOS versions. Settings → Permissions inside ClipVigil always shows the current state and has a Copy diagnostics button that contains no clipboard content.

Clipboard access: set it to Always Allow

Newer macOS versions can ask before an app reads the clipboard in the background. ClipVigil needs to read it to keep your history.

When the system prompt appears, choose Always Allow.

If you chose Don’t Allow, or ClipVigil shows a “Restricted” banner: open System Settings → Privacy & Security → Paste from Other Apps, find ClipVigil, and set it to Always Allow. Then quit and reopen ClipVigil.

While access is restricted, ClipVigil cannot record new copies. It will not crash; you can still use snippets and add the current clipboard by hand with ⌥⌘V.

Accessibility: needed only to paste for you

ClipVigil uses Accessibility to send ⌘V to the front app, so ⌘↵ pastes directly.

Open System Settings → Privacy & Security → Accessibility, switch ClipVigil on. If it is listed but not working, switch it off and on again, or remove it with − and re-add it.

Without it, ⌘↵ copies the item and you paste yourself. Nothing else is affected.

Still stuck

Open Settings → Permissions, click Copy diagnostics, and email it to us. It lists permission states and app version, and contains no clipboard content. support@clipvigil.app