Documentation

Getting started

StackClip runs in your menu bar. Click the icon to open the clipboard history. You can paste clips, run actions, and manage snippets without leaving your app. See the feature pages for details on classification, actions, snippets, and secret masking.

Keyboard shortcuts

Global shortcuts work when StackClip is in the background. All shortcuts are configurable in Settings.

Shortcut	Action
Cmd+Shift+V	Paste last clip into focused app
Cmd+Shift+H	Open clipboard history
Cmd+Shift+1–9	Paste clip 1–9 by position
Cmd+Shift+S	Paste first snippet
Cmd+Shift+0	Copy last clip to clipboard

Permissions (macOS)

For global shortcuts and paste-into-app to work, grant Input Monitoring and Accessibility in System Settings → Privacy & Security. StackClip will prompt you on first use.

Content types

StackClip automatically detects 18 content types. Detection runs in order (first match wins): JWT, JSON, Markdown, YAML, TOML, XML, GraphQL, Diff, curl, URL, env_line, ini, CSV, SQL, shell, code, plain_text, unknown. Each clip shows a type badge; you can filter by type. See Smart classification for details.

Snippets

Save boilerplate—API calls, SQL, config blocks—for quick paste. Use placeholder variables like {{API_KEY}} or {{NAME}} for reusable templates. Name and search your snippets in the Snippets view. See Snippets for more.

Transforms and actions

One-click actions: format JSON, minify, sort JSON keys, decode JWTs, run language-aware code formatting. Supported formats: JSON, SQL, YAML, XML, TOML, GraphQL, CSV, INI, Markdown. Plus: CSV to Markdown table. Code formatting supports JavaScript, TypeScript, Python, Rust, Go, HTML, CSS, Markdown, Java, Kotlin, Ruby. Build pipelines: chain Format JSON → Minify → Copy. Save pipelines as quick actions. See Contextual actions and Transform pipelines.

Data and privacy

All clipboard history and snippets are stored locally in SQLite on your Mac. Retention is configurable (10–5,000 clips); older clips are pruned; pinned clips are never removed. Export and import your data anytime. See Privacy Policy for full details.

Export and import

Export clips and snippets to JSON. Import from JSON to restore or move your data between machines. Your data, your control.

Pin clips

Pinned clips are never pruned. Keep important clips indefinitely, even when retention limits remove older unpinned items.

Settings

Configure retention (10–5,000 clips), remap keyboard shortcuts, and toggle "Paste JSON formatted when using shortcuts" for formatted paste via Cmd+Shift+V.