KeyclashLooks up any key combination
Type or record keys to see each app that uses them, the same key with other modifiers, and free keys nearby.
Version 0.1.0 for macOSFree and open source
A keyboard shortcut map for your Mac
Keyclash reads macOS, your app menus and tool configs, lists every keyboard shortcut it finds, and marks the ones that clash.
One key, every app that uses it
Hold or click the modifier keys. Each key turns free, used, shared, blocked or red for a clash. Click a key to see who owns it.
- Free
- Inside one app
- Several apps, each its own
- A system-wide tool takes it
- Clash
⌘ + key
Click a key to see its apps
Peek shows the shortcuts of the app in front
Press Command twice in any app. Type to filter, then press Return to run the shortcut. Hold the second press to see Peek only while you hold.
- Shift, Option or Control lights up the shortcuts that use them
- A row marks a key that another tool takes system-wide
- You can change the trigger or turn Peek off
Four more ways to read your keys. Each one is a tab in the app.
Exports every shortcut as CSV
One table of every shortcut, sorted by any column, saved as Markdown or CSV in your Downloads folder.
Counts the shortcuts you press
Off until you turn it on. It counts presses with ⌘, ⌃, ⌥ or fn per app and day, and never what you type.
Lets an agent propose key changes
Run keyclash --mcp to connect an agent. It proposes a change as a diff; you approve it, and undo is one call.
Your shortcuts stay on your Mac
Keyclash has no network code. Its scans, counts and backups are plain files in one folder that you can read or delete.
- Accessibility permission reads live app menus
- The key listener passes each key on unchanged
- Full Disk Access is optional, for sandboxed apps
Keyclash source code, built with Cargo
Keyclash is a Rust app built on egui. Clone the repository and one Cargo command opens the window.
- Apple Silicon and Intel, macOS 11 or later
- Tested on one Mac so far. Reports from yours help.
- Not signed by Apple yet, so macOS asks you once
Questions
Something wrong on your Mac? Open an issue on GitHub.
Is Keyclash free?
Yes. The source is on GitHub to fork and change.
Why does Keyclash need Accessibility?
To read the menus of open apps and to see the double ⌘ press for Peek. Without it, you still get the shortcuts in files.
Does Keyclash record my typing?
No. The counter is off until you turn it on, and it stores only key combinations with a modifier, per app and day.
Which tool configs does Keyclash read?
AeroSpace, OmniWM, skhd, Karabiner-Elements and Wispr Flow, plus macOS settings and app menus.
Why does macOS warn about the app?
Version 0.1.0 has no Apple Developer ID yet. Allow it once in System Settings › Privacy & Security.