Skip to content

A tiny friend in your Mac's notch and on your iPhone that keeps an eye on your AI coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more. Approve from the notch or your Lock Screen.

Merge pull request #370 from Louis-CFM/winlinux/shortcuts-parity

Louisaf6c4ed3ffe3
diff --cc windows/README.md
index 407212e7,85a39b0a..b3a84723
--- a/windows/README.md
+++ b/windows/README.md
@@@ -525,31 -528,17 +532,31 @@@ What changes on Linux
for `sh`, and its config under `~` (see Supported agents). A config that is a
symlink (dotfiles) is written through to its target, with its permissions
kept.
-- **Global shortcuts** are X11 key grabs, so they work in an X11 session.
+- **Global shortcuts** are X11 key grabs in an X11 session.
On X11, AltGr is a modifier of its own and never clashes with `Ctrl+Alt`;
combinations the desktop already uses (GNOME's `Ctrl+Alt+T` terminal and
- `Ctrl+Alt+←`/`→` workspace switching) show up as *In use*. Wayland has no
- key grabs — the GlobalShortcuts portal isn't supported yet — so nothing is
- registered there, and **Settings → Shortcuts** lists commands to bind in your
- desktop's own keyboard settings instead:
+ `Ctrl+Alt+←`/`→` workspace switching) show up as *In use*.
+ Wayland has no key grabs, so there Coucou hands its shortcuts to the desktop
+ through the XDG **GlobalShortcuts portal** (`xdg-desktop-portal`, with a
+ backend that has it: KDE Plasma 6, GNOME 48+, Hyprland, COSMIC…). Each
+ shortcut goes with its description and your keys as the preferred trigger;
+ the desktop may show its own window to confirm them or to pick other keys,
+ and it has the last word: a shortcut it already knows keeps the keys it was
+ given there, and you change them in the desktop's own shortcut settings.
+ **Settings → Shortcuts** says the shortcuts are registered with the desktop,
+ shows next to each one the keys the desktop reports (*Desktop: …*), and flags
+ one it left out. Changing or turning off a shortcut in Coucou binds the new
+ set in a new portal session. Coucou names itself `fr.louisraille.coucou` to
+ the portal where the portal allows it (`xdg-desktop-portal` 1.19+); a
+ desktop that wants an app name may otherwise refuse.
+ Where there is no such portal, or the desktop refuses, nothing is registered
+ and **Settings → Shortcuts** lists commands to bind in your
+ desktop's own keyboard settings instead (they are shown with the portal too,
+ for any shortcut that doesn't work):
`coucou --shortcut openChat` (or the AppImage's path) runs the action in the
Coucou that is already open. The ids are `toggleIsland`, `openChat`,
- `goToAlert`, `jumpToTerminal`, `nextPill`, `prevPill`, `muteToggle` and
- `wardrobeToggle`.
+ `goToAlert`, `jumpToTerminal`, `nextPill`, `prevPill`, `muteToggle`,
+ `desktopToggle` and `wardrobeToggle`.
- **Keys** live in the Secret Service (GNOME Keyring, KWallet).
- **Plan usage**: the status line relay is `~/.local/share/coucou/bin/coucou-hook
--statusline` and runs your previous status line with `/bin/sh -c`, like Claude
diff --cc windows/tests/shortcuts.test.mjs
index bae882f3,c929e4a6..3b92f7f1
--- a/windows/tests/shortcuts.test.mjs
+++ b/windows/tests/shortcuts.test.mjs
@@@ -64,23 -64,18 +64,26 @@@ test("the defaults are the same on bot
);
});
+test("the descriptions the Wayland portal shows are the labels Settings shows", () => {
+ const rust = readFileSync(new URL("../src-tauri/src/shortcuts.rs", import.meta.url), "utf8");
+ const rows = Object.fromEntries(
+ [...rust.matchAll(/^\s*"(\w+)" => n_\("([^"]+)"\),/gm)].map(([, id, text]) => [id, text]),
+ );
+ assert.deepEqual(rows, Object.fromEntries(SHORTCUTS.map((d) => [d.id, SHORTCUT_TEXT[d.id]])));
+});
+
// testEnabledByDefault
- test("only the island toggle is off by default; the two not ported yet are reserved", () => {
+ test("only the island toggle is off by default; the one not ported yet is reserved", () => {
for (const d of SHORTCUTS) {
assert.equal(d.enabledByDefault, d.id !== "toggleIsland", d.id);
- assert.equal(d.ported, !["attachFrontWindow", "desktopToggle"].includes(d.id), d.id);
+ assert.equal(d.ported, d.id !== "attachFrontWindow", d.id);
}
assert.deepEqual(activeKeys({}).map(([id]) => id), [
- "openChat", "goToAlert", "jumpToTerminal", "nextPill", "prevPill", "muteToggle", "wardrobeToggle",
+ "openChat", "goToAlert", "jumpToTerminal", "nextPill", "prevPill", "muteToggle", "desktopToggle",
+ "wardrobeToggle",
]);
+ // The Mac's ⌃⌥D, on the same letter.
+ assert.equal(SHORTCUTS.find((d) => d.id === "desktopToggle").defaultKeys, "Ctrl+Alt+D");
});
// ── Parsing and formatting (testCarbonModifiers, testDisplayString, testKeyCodeToString) ──