A tiny, native macOS window manager for keyboard-first workflows. It uses macOS Accessibility APIs and a global event tap—no Raycast, Hammerspoon, or third-party runtime required.
Hyper means ⌃ Control + ⌥ Option + ⌘ Command.
| Shortcut | Action |
|---|---|
Hyper + ← |
Left half |
Hyper + → |
Right half |
Hyper + ↑ |
Top half |
Hyper + ↓ |
Bottom half |
Hyper + 1 / 2 / 3 |
Left / center / right third |
Hyper + ⇧ + 1 / 2 / 3 |
Left / center / right two-thirds |
Hyper + C |
Center without resizing |
Hyper + H |
Hide focused app |
Hyper + Return |
Maximize |
Hyper + R |
Restore / toggle previous frame |
Hyper + [ / ] |
Previous / next display |
Run windows in a terminal to display the same cheatsheet.
Requirements:
- macOS 13 or newer
- Xcode Command Line Tools (for the Swift compiler)
~/.local/binon yourPATH
Clone the repository and run:
./install.shThe installer:
- Compiles the Swift source into
~/Applications/Window Hotkeys.app. - Ad-hoc signs the app with a stable bundle identifier.
- Installs the
windowscheatsheet command in~/.local/bin. - Registers a user LaunchAgent so the hotkeys start at login.
On first launch, approve Window Hotkeys in:
System Settings → Privacy & Security → Accessibility
The service detects the permission automatically; it does not need to be restarted afterward.
./uninstall.shThe script stops the LaunchAgent and removes the app, command, service definition, and log file.
Validate the source without installing:
./test.shThe project intentionally has no package dependencies. Window geometry is calculated against each display's visible frame, respecting the menu bar and Dock.