Troubleshooting
Common questions.
Most of them are a keystroke, or one macOS setting you only touch once.
Where do I get Rakkun, and is it safe to install?
Rakkun is on the Mac App Store. It installs like any other store app — reviewed by Apple, sandboxed, with the hardened runtime — and it lands in your Applications folder ready to launch. There is no security prompt to click through.
It asks for no macOS privacy permission at all, and it has no network entitlement, so nothing you copy can leave your Mac. See the privacy policy for what that means in practice.
The ⌘⇧V hotkey doesn’t open the panel
Two things to check:
- Make sure Rakkun is running — look for the raccoon in your menu bar. If it isn’t there, launch it from Applications.
- Another app may already own ⌘⇧V. Open Rakkun → Settings → Hotkey and record a new shortcut; the change takes effect immediately.
Pressing ↩ copies the item instead of pasting it
That is what ↩ does. ↩ copies the selected item and closes the panel, and you press ⌘V where you want it — two keystrokes, and the second one is the paste you were going to press anyway. ⌘C opens the other ways to copy the same clip — minified, decoded, converted — and whichever row you pick copies and closes the panel too. On a clip with only one way to copy, ⌘C does exactly what ↩ does.
Rakkun never asks for macOS Accessibility permission and contains no code that presses ⌘V for you — that keystroke stays yours.
How do I select several items?
Hold ⇧ and press ↑ or ↓ to extend the selection from the row you started on. ⇧-click selects everything up to the row you click, ⌘-click adds or removes one row, and ⌘A selects everything your current search is showing. esc clears the selection.
With two or more selected, the preview shows a summary — how many, which kinds, from which apps — instead of any clip’s contents. ↩ copies them as one Markdown bundle, ⌘C offers them joined with newlines instead, and ⌘⌫ deletes them all except the pinned ones. A slipped ⌘⌫ isn’t final: ⌘Z, or a click on the toast, puts everything back within five seconds, as long as the panel is still open.
What does Copy for LLM actually do to my text?
It makes a large clip smaller without rewriting it. JSON keeps every key and its shape: an array longer than three keeps its first three items and ends with a "… 1240 more items" string, a very long string is cut with a note of how much went, and the result is still valid JSON. In a log, a run of identical lines becomes one line ending in ×N — with the time range, when the lines start with a timestamp — and long runs of blank lines collapse. A stack trace keeps your own frames whole and in order, and folds each run of framework frames into one line such as … 14 frames in UIKitCore.
Nothing is paraphrased, reordered or summarized. Every cut is written into the output, where you — and the model — can see it.
The row shows its estimate before you pick it: Copy for LLM · ~4.8k → ~571 tokens. Those are approximations — about four bytes per token, a little fewer for JSON — not a tokenizer’s count, which is why they always carry the ~. Detected secrets are stripped from the output, and the row says how many.
It all happens on your Mac. Rakkun has no network entitlement, so no model, API or server is involved — it puts the trimmed text on your clipboard, and you paste it where you choose.
Why isn’t Copy for LLM offered on this clip?
It is the first row of the Transform menu (⌘T) only when it would actually help. A missing row means one of these:
- The clip is small. It needs an estimated 1,500 tokens — about 6 KB of text, a little less for JSON — and the trim has to save at least a quarter of it.
- It’s a kind Rakkun doesn’t trim. Only JSON, plain text and logs, and stack traces. SQL and curl never are: a shortened query or request is a wrong one, not a smaller one.
- It’s sensitive. A clip you marked secret, an API key or a JWT is never offered — the whole clip is the credential. A log or config with a key inside is still offered, with the key stripped.
- The trimmed result would be over 8 KB. Every result is scanned for secrets before it’s offered, and past that size the scan can’t be kept fast, so Rakkun leaves the row out.
- Several clips are selected. ⌘T works on one clip; for several, ↩ copies them as a bundle.
After the free trial the Transform menu, Copy for LLM included, is part of the one-time unlock — if your trial has ended, ⌘T shows the unlock instead of its rows.
Things I copy from my password manager never show up
That’s deliberate, and it’s one of Rakkun’s core promises. Anything a password manager marks as a concealed pasteboard type is never recorded — not masked, not stored, not seen. Apple’s Passwords app and Keychain Access don’t set that flag, so Rakkun refuses their copies by app instead, along with the other password managers it knows. Settings → Privacy → Excluded apps lists the ones installed on this Mac; the rest stay excluded all the same, and appear there on their own if you install one. You can add any other app — or remove one you do want recorded.
Where is my clipboard history stored? Is any of it uploaded?
Everything stays on your Mac. There’s no account, no sync service, and no server — nothing you copy ever touches a network, and there’s zero telemetry on clipboard contents.
Detected secrets are masked on screen. Unpinned secrets live only for the session; pinning one moves it into the macOS Keychain, and only a masked stub is written to disk.
How do I stop Rakkun from recording a specific app?
Open Settings → Privacy and add the app to the excluded list. From then on, anything copied while that app is frontmost is ignored — the same mechanism that protects password managers automatically.
Launch at login won’t stay enabled
macOS gates login items behind its own approval. Toggle Launch at login in Settings → General; if it reverts, check System Settings → General → Login Items and allow Rakkun there. The toggle reflects the real system state, so it will settle once macOS approves it.
How do I update Rakkun?
Through the Mac App Store, like every other store app — open App Store → Updates, or leave automatic updates on in System Settings → General → Software Update and Rakkun keeps itself current. Your history, pins and settings survive an update.
Which macOS versions are supported?
Rakkun runs on macOS 14 Sonoma and later, on both Apple Silicon and Intel Macs.
Does the screenshot text recognition (OCR) work offline?
Yes. OCR uses Apple’s on-device Vision framework — copied images are read entirely on your Mac and never sent anywhere, just like the rest of your clipboard.
Can Rakkun turn a copied SVG into a PNG?
Yes. Copy SVG markup — Figma’s “Copy as SVG”, a web inspector’s “copy element”, the contents of an icon file — and the preview draws it. ⌘C offers Copy as PNG at the size the document declares, at 1× and 2×, with the exact pixel dimensions in each menu item, plus a data:image/svg+xml;base64,… data URI and the plain source.
Two caveats worth knowing. Rakkun only treats a clip as an SVG when the clip is the document — markup pasted inside a React component or an HTML page stays plain text. And the drawing comes from macOS’s own renderer rather than a browser engine: <style> rules and filters are applied, <foreignObject> HTML is not drawn, and a document that declares no size and no viewBox gets the facts and the source but no picture.
How do I uninstall Rakkun?
- Click the menu-bar icon and choose Quit.
- Drag Rakkun from Applications to the Trash.
- Optional: remove the login item under System Settings → General → Login Items.
Want every trace gone, including pinned secrets in the Keychain? Email us and we’ll send the exact paths.
Still stuck?
Talk to a person.
Rakkun is made by a small team that reads every message. Tell us your macOS version and what you were doing, and we’ll usually reply within a day.