[antonmos]

What

A new opt-in switch, --alt-q-quit (config ALT_Q_QUIT=1, plus an Option+Q quits apps toggle in the menu-bar Settings → App switching), that delivers Option+Q (Alt+Q from a Windows client) to the focused app as Cmd+Q.

Why

Quitting a Mac app from a Windows client currently needs Win+Q. mstsc swallows Win-combos when windowed ("Apply Windows key combinations"), and the macOS Windows App forwards Cmd only as a tap, so there was no reliable way to quit. This is the Option-key counterpart to --alt-tab-switch / --alt-backtick-switch.

How

• Caught in try_symbolic_hotkey (src/input.rs), next to the Option+Tab/Option+` triggers, so it runs before the Ctrl→Cmd remap and layout translation.
• Posts a full Cmd+Q tap with the same FlagsChanged-on-both-event-sources pattern as post_ctrl_as_cmd, then restores the real held-Option state. The Q key-up is swallowed via consumed_keys.
• Plain Option only. Option+Shift+Q is deliberately not turned into Cmd+Shift+Q (log out), and Cmd/Ctrl combos pass through unchanged. The gate is a pure function, should_alt_q_quit, covered by an exhaustive decision-table test (alt_q_quit_decision_table).
• Off by default. With the switch off, Option+Q reaches apps as a normal key (œ on US layouts). With it on, Option+Q is lost in every app, including a terminal that uses Option as Meta.

Q in the switcher. With Cmd+Tab (or Option+Tab under --alt-tab-switch) still held, Q quits the highlighted app, as in the native switcher, rather than whichever app is frontmost. The app is removed from the switcher's list (and the HUD), asked to quit via NSRunningApplication.terminate (a normal quit, so save prompts still appear), and the switcher stays open on the next app. Quitting the last app ends the switcher session. This needs no flag, since the session only exists while the switcher is held. The index logic is a pure function with a test (switcher_quit_moves_selection_to_the_next_app).

Docs: docs/cli.md, docs/configuration.md, docs/features.md, README, packaging/config.env.example.

Testing

• cargo build clean; cargo test coord_tests passes, including the new decision-table test.
• Live-verified on a real RDP client against the installed /Applications/macrdp.app: Alt+Q quits the focused app, and Q pressed in the Alt+Tab switcher quits the highlighted app (log: app switcher: quit the selected app pid=… sent=true).
• The Settings toggle wasn't compiled locally: swift build in gui/ fails on this machine's Command Line Tools (SwiftUI @State macro plugin not found), with or without this change. The change there is one Toggle line that matches its neighbours.

🤖 Generated with Claude Code

[clintcan]

Thanks @antonmos. This now conflicts with main in six files (src/input.rs, src/main.rs, README, docs/configuration.md, docs/features.md, packaging/config.env.example). Since it was opened, #192, #208, #209, #210 and #212 have landed and touch the same places, mostly the flag lists and try_symbolic_hotkey.

#197 changes the same switcher code, so I'll review that one first. Could you rebase this one once #197 is settled? That way you only resolve the conflicts once. I'll review it after the rebase.