Global hotkeys
Summon CompozyOS or run a command from anywhere through the desktop shell.
1 min read1 pages in Desktop
On this page3
The desktop app can register one global chord for each command from anywhere outside CompozyOS. The
default map includes meta+shift+Space for palette.summon.global, which restores and focuses
CompozyOS with the palette open.
Configure a hotkey
Use Settings → Shortcuts, or update the daemon-owned map from the CLI:
compozy cmd-palette bind session.new meta+shift+KeyN --global --workspace acme
compozy cmd-palette unbind session.new --global --workspace acmeAdd --overwrite only after reviewing the command that currently owns a conflicting chord. The
daemon transfers the chord as one atomic change.
The equivalent configuration is:
[window_manager.global_shortcuts]
"palette.summon.global" = "meta+shift+Space"
"session.new" = "meta+shift+KeyN"See Keyboard shortcuts for the chord grammar and in-app bindings.
Registration states
The daemon stores the intended map. Each running desktop shell reports what it registered on that machine:
- Active — the shell confirmed the chord.
- Captured — another application owns the intended chord. If the command had a previous working chord, CompozyOS restores and shows it.
- Permission required — macOS Accessibility permission blocked registration. Use Open System Settings from the callout, grant access, and return to retry.
- Unsupported — Electron cannot convert or register that chord.
Quit releases every registered chord. Relaunch reads the intended map, registers it again, and
reports fresh status. Settings shows the registration reported by the current profile's shell.
HTTP/UDS clients can select it with client_id and client_profile on
GET /api/settings/window-manager and its PATCH echo. client_profile identifies the shell's
profile; scope and workspace_id continue to select the configuration being edited.
Browser mode
The daemon-served web app still supports in-app shortcuts such as meta+KeyK, but a browser tab
cannot own system-wide hotkeys. Settings keeps the global section visible and disabled with the
reason requires desktop shell.
The recorder stores physical key codes. On non-QWERTY layouts, the printed legend may differ from the physical key that activates the chord.