From f49fdd3e8bf836c94874963fcc57cdfe72ba41a0 Mon Sep 17 00:00:00 2001
From: Pierre Le Fevre <hello@pierrelf.com>
Date: Wed, 25 Feb 2026 18:15:15 +0100
Subject: [PATCH] add readme

---
 README.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..52fc2f0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# Mission Control Turbo
+Turbocharge your macOS experience!
+
+Mission Control Turbo is a lightweight macOS application that replaces the built-in Mission Control experience.
+
+## Features
+
+- **Global hotkey** — trigger the overlay from anywhere (default: `⌃↑`)
+- **Live window thumbnails** — captured via ScreenCaptureKit
+- **Keyboard navigation** — arrow keys to move between windows, Return to select, Escape to dismiss
+- **Multi-display support** — overlay appears on every connected screen
+- **Grouped by app** — windows are organized under their app name and icon
+- **Menu bar extra** — access the overlay, settings, and quit from the menu bar
+- **Configurable** — change the hotkey in Settings
+
+## Requirements
+
+- macOS 26 Tahoe
+- Apple Silicon (arm64)
+
+## Permissions
+
+Mission Control Turbo requires two system permissions:
+
+| Permission           | Reason                                          |
+| -------------------- | ----------------------------------------------- |
+| **Accessibility**    | Register the global hotkey and activate windows |
+| **Screen Recording** | Capture window thumbnails for the overlay       |
+
+You'll be prompted to grant these on first launch. They can also be managed in **System Settings → Privacy & Security**.
+
+> **Tip:** To use the default `⌃↑` hotkey, disable the native Mission Control shortcut in **System Settings → Keyboard → Keyboard Shortcuts → Mission Control**.
+
+## Building
+
+```bash
+./build.sh
+```
+
+The built app bundle will be at `build/MCT.app`.
+
+## AI disclaimer
+This project was largely developed using Claude Code Opus 4.6 as an experiment in AI-assisted software development.
\ No newline at end of file
-- 
2.51.2