Every answer.

Getting set up

What do I need to run Hopper?

A Mac running macOS 26 or later.

Which permissions does Hopper need?

Accessibility is recommended: it lets Hopper see your windows and tabs and switch apps. Full Disk Access is optional and adds browser history, bookmarks, Notes and Messages. macOS also asks once per browser before Hopper reads its tabs. Hopper works without any of them, but sees much more with them.

Setup, step by step
⌘Space opens Spotlight instead of Hopper.

Turn off Spotlight’s shortcut in System Settings ▸ Keyboard ▸ Keyboard Shortcuts ▸ Spotlight, or record a different key for Hopper in its Settings.

Can I use Hopper alongside Raycast?

Yes. Switch Hotkeys hands Hopper’s hotkeys and gestures to Raycast and takes them back. The menu bar item tells you which app has them.

How do I change a shortcut?

Open Hopper’s Settings and go to Shortcuts. Click a shortcut and press the keys you want. You can record any combination.

Every default shortcut

Back & Toggle

How do I go back to where I was?

Press ⌃⌥← to go Back to the place you were before, in any app: the exact tab, doc, window or session. ⌃⌥→ goes Forward again.

How navigation works
What’s the difference between Toggle and Toggle Tab?

Toggle (double-tap ⌘) flips between your two most recent apps. Toggle Tab (double-tap ⌥) flips between your two most recent tabs, windows or sessions, even inside one app.

How long does Hopper keep my history?

30 days by default. You can make it 7 or 90 days, or clear it whenever you like. Press and release ⌃⌘ to see it.

Can I reopen a tab I closed by accident?

Yes. Recently Closed keeps tabs that closed while their browser kept running, and reopens them in the same browser.

Agents

Which coding agents work with Hopper?

Claude Code, the Claude app, Codex and Cursor, plus agents running in herdr. Press ⌥Space to see them all.

About Agents
What do Needs You, Done, Working and Idle mean?

Needs You: stopped to ask you something. Done: finished since you last looked. Working: busy right now. Idle: nothing new. Once you’ve seen a Done agent, it moves to Idle.

Why don’t Codex or Cursor show Needs You?

Claude Code and Claude say when they stop to ask you something, so Hopper can show Needs You for them. Codex and Cursor show Working, Done and Idle.

Do I need to install hooks or plugins in my agents?

No. Hopper reads each agent’s own files on your Mac. Nothing is installed into Claude Code, Codex or Cursor.

Windows

Why don’t window shortcuts do anything?

Window commands have no shortcuts until you set them. Type a command in search (“left half”), give it a hotkey, or import a preset.

About Windows
Can I import shortcuts from Rectangle, Magnet or Spectacle?

Yes, in one go. Hopper tells you first if one of them is already taken, like ⌃⌥← and ⌃⌥→, which are Back and Forward.

Hotkey presets

Clipboard & Snippets

How do I turn on Clipboard History?

It’s off until you turn it on in Hopper’s Settings. It skips anything your password manager marks as secret, and you choose how long entries are kept.

How do snippets work?

Type a snippet’s keyword in any app and it becomes the snippet’s text. Snippets never expand in password managers or excluded apps.

Privacy

Does Hopper upload my data?

No. Hopper reads, stores and searches everything on your Mac. The one exception is Online Lookups: for Hulu and Netflix links it fetches the public page, signed out, to name the episode. Turn it off in Settings ▸ Privacy ▸ Online Lookups.

What stays on your Mac
How do I stop Hopper from seeing an app?

Exclude it in Settings ▸ Privacy. An excluded app is never indexed or recorded, and won’t show up in search, Back or Clipboard History.

Every privacy control
Does Hopper see private or incognito windows?

No. Incognito and private browser windows never reach Hopper.

Waitlist & testing

How do I get Hopper?

Hopper is in private testing. Join the waitlist and we’ll email you when there’s a build for you. One email when Hopper is ready, nothing else.

Join the waitlist
How do I leave the waitlist?

Reply to any email from us, or email [email protected], and we’ll remove you.

How do I report a bug or suggest something?

Email [email protected]. We’d love to hear it.

Didn’t find it? Watch it in Tips, or email [email protected].