Getting Started

Getting Started

Installation

Option 1: Download Release

1. Download ClipStash.app.zip
2. Extract and move to /Applications
3. First launch (app is open-source but not Apple-notarized):
   • Right-click the app → Open → Click Open in dialog
   • Or in Terminal: xattr -cr /Applications/ClipStash.app

Why this step? macOS Gatekeeper blocks apps not signed with Apple Developer ID ($99/year). ClipStash is open-source and safe — you can verify the code yourself.

Option 2: Build from Source

git clone https://github.com/kiku-jw/ClipStash.git
cd ClipStash
open ClipStash.xcodeproj

Press ⌘B to build, ⌘R to run.

---

First Launch

1. ClipStash appears in your menu bar (clipboard icon)
2. Click the icon to open the clipboard history
3. Everything you copy will now be saved

---

Basic Usage

Action	Shortcut
Open history	Click menu bar icon
Navigate	↑ / ↓
Copy item	Enter or single-click
Search	⌘F or just start typing
Delete item	⌘⌫
Pin/unpin	⌘P
View full content	Double-click

---

Tips

• Pin important clips — they survive cleanup and stay at top
• Use search — FTS5 finds items instantly even with thousands of clips
• Export for NotebookLM — Settings → Export tab → auto-splits to ~180KB files