Mission Control Turbo: macOS multitasking turbocharged
at main 60 lines 2.4 kB view raw view rendered
1# Mission Control Turbo 2Turbocharge your macOS experience! 3 4Mission Control Turbo is a lightweight macOS application that replaces the built-in Mission Control experience. 5 6## Features 7 8- **Global hotkey** — trigger the overlay from anywhere (default: `⌃↑`) 9- **Live window thumbnails** — captured via ScreenCaptureKit 10- **Keyboard navigation** — arrow keys to move between windows, Return to select, Escape to dismiss 11- **Multi-display support** — overlay appears on every connected screen 12- **Grouped by app** — windows are organized under their app name and icon 13- **Menu bar extra** — access the overlay, settings, and quit from the menu bar 14- **Configurable** — change the hotkey in Settings 15 16## Requirements 17 18- macOS 26 Tahoe 19- Apple Silicon (arm64) 20 21## Permissions 22 23Mission Control Turbo requires two system permissions: 24 25| Permission | Reason | 26| -------------------- | ----------------------------------------------- | 27| **Accessibility** | Register the global hotkey and activate windows | 28| **Screen Recording** | Capture window thumbnails for the overlay | 29 30You'll be prompted to grant these on first launch. They can also be managed in **System Settings → Privacy & Security**. 31 32> **Tip:** To use the default `⌃↑` hotkey, disable the native Mission Control shortcut in **System Settings → Keyboard → Keyboard Shortcuts → Mission Control**. 33 34## Building 35 36```bash 37./build.sh 38``` 39 40The built app bundle will be at `build/MCT.app`. 41 42### Code signing 43 44The build script ad-hoc signs the app by default (using `codesign -s -`). This is sufficient to run locally, but macOS will reset permissions (Accessibility, Screen Recording) every time you rebuild. 45 46To preserve permissions across builds, sign with a self-signed certificate: 47 481. Open **Keychain Access** 492. Go to **Keychain Access > Certificate Assistant > Create a Certificate...** 503. Enter a name (e.g. `Your Name`), set **Certificate Type** to **Code Signing**, click **Create** 514. Create a `.env` file in the project root (git-ignored): 52 53```bash 54echo 'CERT_NAME="Your Name"' > .env 55``` 56 57The build script reads `CERT_NAME` from `.env` automatically. When set, the app is signed with your certificate and macOS will remember granted permissions between rebuilds. 58 59## AI disclaimer 60This project was largely developed using Claude Code Opus 4.6 as an experiment in AI-assisted software development.