Install & first run

Three steps: install, open past the Gatekeeper warning, grant permissions. About three minutes total.

Install

Via Homebrew

brew tap mekedron/tap
brew install --cask clipslop

Via the DMG

Grab the latest .dmg from Releases and drag ClipSlop.app to your Applications folder.

After install, ClipSlop lives in your menu bar:

Opening the app for the first time

ClipSlop is not signed with an Apple Developer certificate — we don't pay Apple's $99/year. macOS will block it on first launch, which is expected.

The app is safe: the source is fully open and every release is built by GitHub Actions directly from the public repository.

To open it:

1. Drag ClipSlop.app to your Applications folder.
2. Double-click — macOS shows a warning and refuses.
3. Open System Settings → Privacy & Security.
4. Scroll down — you'll see "ClipSlop was blocked from use because it is not from an identified developer".
5. Click Open Anyway, then confirm.

Subsequent launches open normally.

Grant permissions

ClipSlop needs two macOS permissions to work in any app:

• Accessibility — required to read the text you've selected and paste results back. Grant in System Settings → Privacy & Security → Accessibility.
• Screen Recording — only needed for the OCR feature (⇧⌘2). Grant in System Settings → Privacy & Security → Screen Recording.

After updating to a new version

Because the app is unsigned, macOS may change the bundle identifier between versions and invalidate previously granted permissions. If shortcuts stop working after an update:

1. Open System Settings → Privacy & Security → Accessibility.
2. Find ClipSlop in the list and remove it (select → click "−").
3. Click "+" and re-add ClipSlop.app from your Applications folder.
4. Repeat for Screen Recording if you use OCR.

Your prompts and settings are never affected.

Continue with Pick a provider — ClipSlop calls a real AI model for every transformation, so you need at least one provider configured.