A little help

Need a hand?

From your first two taps to an everyday habit.

For macOS 26 or later
01 — Getting started

Three small steps first.

  1. Open the app. After installing, open CmdFlick’s native control window. The feature starts off on first use. The Dock icon is visible while the window is open.
  2. Allow Input Monitoring. Click Open Input Monitoring Settings, then enable CmdFlick in System Settings → Privacy & Security → Input Monitoring. The permission section appears first. The window stays open while you visit System Settings, and the permission section disappears after access is granted. Quit and reopen if macOS asks you to.
  3. Switch on, then tap twice. After granting permission, turn on Enable double-Command. Press and release the same Command key twice; either side works. With the switch on, the Close button hides the window and Dock icon while the feature keeps running in the background.
02 — Common questions

Good things to know.

Does clicking Close stop the feature? How do I return to the window?

It depends on the feature switch. When it is on, clicking Close hides the control window and Dock icon while gesture detection continues in the background. When it is off, clicking Close ends the app. The switch takes effect immediately and remembers your choice.

Open CmdFlick again from the Applications folder in Finder to return to the same control window. The window stays open when you visit System Settings. While the control window is visible, Command-Q and a normal Quit from the Dock follow the same rule. System requests to quit and reopen still end the process.

How quickly should I tap?

Press and release Command fully each time. Hold each press for no more than 0.25 seconds and leave no more than 0.35 seconds between releasing the first tap and pressing the second. Both taps must use the same key. Long presses, alternating sides, or holding both Command keys will not trigger the gesture.

Why does it need Input Monitoring?

The app needs to recognize the gesture while other apps are in the foreground, and rule out ordinary shortcuts and mouse actions. It handles only necessary key codes, states, and timing. It does not extract typed text or save or upload keystrokes. Read the full privacy policy.

The gesture is not responding. What should I check?
  1. Open CmdFlick again. If the permission section is shown, allow Input Monitoring first, then turn on Enable double-Command. If the switch is already on, granting permission enables monitoring automatically. Showing the control window does not pause the gesture.
  2. Use the same Command key twice without other keys, clicks, dragging, or scrolling between taps.
  3. If you moved the app or changed its signature, check whether permission needs to be granted again.
  4. Check the monitoring status in the control window or any Spotlight error. To restart the app, turn the feature off and click Close, then reopen CmdFlick and switch it on again.
  5. Check Spotlight itself using the macOS system shortcut. CmdFlick does not change Spotlight’s settings.
Why can it pause while I am entering a password?

A password field or another app may enable macOS Secure Input. CmdFlick pauses global gesture monitoring while that protection is active. Leave the secure input context, wait a moment, and try again; reopen CmdFlick if necessary. There is no need to disable system security features.

Will it affect shortcuts like Command-C or Command-V?

Monitoring is read-only: input is not suppressed or changed. Ordinary keys, other modifiers, mouse actions, and long presses cancel a pending gesture. Three consecutive taps produce only one double tap. Caps Lock being on does not affect the gesture.

How do I enable launch at login or quit completely?

Turn on the Launch CmdFlick when I log in switch to apply the setting immediately; turn it off to disable login startup. It is off by default and independent of the feature switch. If macOS requests approval, review it in System Settings → General → Login Items & Extensions. Future login launches stay silent and use the remembered feature switch state.

To quit completely, turn off Enable double-Command, then click Close. This preserves the login setting. To also prevent the next login launch, turn off the launch-at-login switch first. No separate daemon restarts the app.

Which languages does the app support?

The app supports Simplified Chinese and English and follows your system’s preferred language automatically. Other languages use English. There is no separate language setting in the app.

Where can I get it? Source or App Store?

CmdFlick is available as source code under GPLv3 (GPL-3.0-only), so you can build it on your Mac. A paid Mac App Store download is planned. Both focus on the same double-tap feature; the store option saves you the build steps. Store availability and pricing have not been announced.

See the options and their current status.

03 — Contact support

Still need help?

Include your macOS version, CmdFlick version, keyboard type, and steps to reproduce the issue. Do not send passwords or screenshots containing private search results.

Open a GitHub issue ↗

Issues are public. Do not include private information.