Hotkeys

Overview

SuperCmd supports global keyboard shortcuts for:

Global launcher hotkey — Open SuperCmd from anywhere
Per-command hotkeys — Launch specific commands directly
Hyper Key — Remap a modifier key to Cmd+Ctrl+Option+Shift
In-app shortcuts — Navigate within SuperCmd

All hotkeys work system-wide when SuperCmd is running in the background.

Global Launcher Hotkey

The primary shortcut to open SuperCmd. Default: Alt+Space (Option+Space) Configure:

Open SuperCmd
Search for “Settings”
Navigate to General → Global Shortcut
Click the field and press your desired key combination

Popular alternatives:

Shortcut	Notes
`Command+Space`	Requires disabling Spotlight in System Settings
`Option+Space`	Default (Alt+Space)
`Control+Space`	May conflict with input source switching
`Command+Shift+Space`	Good alternative if Spotlight is enabled
`Fn+Space`	Uses the Function key (requires Input Monitoring)

Technical details: SuperCmd uses Electron’s globalShortcut.register() API, which requires Input Monitoring permission. Source: src/main/main.ts:186-205

globalShortcut.register(globalShortcut, () => {
  if (mainWindow.isVisible()) {
    mainWindow.hide();
  } else {
    mainWindow.show();
    mainWindow.focus();
  }
});

Per-Command Hotkeys

Assign global shortcuts to launch specific commands instantly, bypassing the launcher UI.

Setting Up Command Hotkeys

Via Settings UI:

Open a command

Search for any command in SuperCmd

Open Actions panel

Press Cmd+K or click the Actions icon

Choose 'Set Hotkey'

Select the action and press your desired key combination

Via settings.json:

{
  "commandHotkeys": {
    "supercmd-clipboard-history": "Command+Shift+V",
    "supercmd-window-management": "Control+Option+W",
    "supercmd-snippets": "Command+Shift+S",
    "com.raycast.extension.calculator": "Command+Shift+C"
  }
}

Command ID Format

Built-in commands: supercmd-{feature}
- Example: supercmd-clipboard-history
Extension commands: {extension-name}#{command-name}
- Example: github#search-repositories
Script commands: script:{filename}
- Example: script:toggle-wifi.sh

Finding Command IDs

Enable debug mode in Settings
Open DevTools (Cmd+Option+I)
Run a command
Check console logs for the command ID

Or inspect ~/Library/Application Support/SuperCmd/settings.json → recentCommands array.

Hyper Key

SuperCmd includes a built-in Hyper Key feature that remaps a physical key to act as Cmd+Ctrl+Option+Shift simultaneously.

Use Cases

Remap Caps Lock to Hyper
Remap Right Option to Hyper
Create super-powerful shortcuts without finger gymnastics

Setup

Choose source key

Common choices:

Caps Lock (keycode 57)
Right Option (keycode 61)
Right Command (keycode 54)

Configure SuperCmd

{
  "hyperKeySource": 57,
  "hyperKeyIncludeShift": false,
  "hyperKeyQuickPressAction": "escape"
}

Test

Press your Hyper Key + any letter to create a unique shortcut

Hyper Key Settings

hyperKeySource

number | null

default:"null"

Keycode of the physical key to remap

hyperKeyIncludeShift

boolean

default:"false"

Include Shift in the Hyper combination (Cmd+Ctrl+Option+Shift)

hyperKeyQuickPressAction

string

default:"escape"

Action when Hyper Key is tapped (not held):

escape — Send Escape key
toggle-caps-lock — Toggle Caps Lock
none — Do nothing

hyperReplaceModifierGlyphsWithHyper

boolean

default:"false"

Show shortcut badges as “⌘Hyper” instead of ”⌘⌥⌃⇧“

How It Works

SuperCmd monitors keyboard events using CGEventTapCreate() and:

Intercepts the source key press
Suppresses the original key event
Injects Cmd+Ctrl+Option (+ Shift if enabled)
On release, removes all modifiers
On quick tap, sends the quick-press action

Source: src/native/hotkey-hold-monitor.swift, src/main/main.ts (hyper-key IPC handlers)

Hyper Key requires Accessibility and Input Monitoring permissions.

In-App Shortcuts

Keyboard shortcuts within SuperCmd:

Shortcut	Action
`Cmd+K`	Open Actions panel
`Cmd+,`	Open Settings
`Cmd+Shift+P`	Command palette (extensions)
`Escape`	Close window / go back
`Cmd+W`	Close window

Search & Filtering

Shortcut	Action
`↑` / `↓`	Navigate results
`Enter`	Execute selected command
`Cmd+Enter`	Execute with modifiers
`Tab`	Autocomplete (if available)
`Cmd+Backspace`	Clear search

List & Grid Views

Shortcut	Action
`Cmd+↓`	Show detail panel
`Cmd+Y`	Quick Look (if supported)
`Cmd+C`	Copy selected item
`Cmd+D`	Toggle detail sidebar

Form Views

Shortcut	Action
`Tab` / `Shift+Tab`	Navigate fields
`Enter`	Submit form
`Cmd+Enter`	Submit with metadata

Extension Shortcuts

Extensions can define custom shortcuts using the Keyboard.Shortcut type:

import { Action, ActionPanel } from "@raycast/api";

<Action
  title="Open"
  onAction={() => console.log("Opened")}
  shortcut={{ modifiers: ["cmd"], key: "o" }}
/>

Supported modifiers:

cmd — Command
ctrl — Control
opt / alt — Option
shift — Shift

Shortcut Format

SuperCmd uses Electron’s accelerator syntax:

Modifier+Modifier+Key

Examples:

Command+Shift+V
Control+Option+W
Alt+Space
Cmd+K

Modifiers:

Command / Cmd / ⌘
Control / Ctrl / ⌃
Option / Alt / ⌥
Shift / ⇧

Special keys:

Space, Tab, Enter, Escape
Up, Down, Left, Right
F1–F24
A–Z, 0–9

Conflict Detection

SuperCmd does not automatically detect conflicts with system shortcuts or other apps. Common conflicts:

Shortcut	System Use
`Command+Space`	Spotlight
`Control+Space`	Input source switching
`Command+Tab`	App switcher
`Command+Option+D`	Show/hide Dock

Check System Settings → Keyboard → Keyboard Shortcuts for existing system shortcuts.

Troubleshooting

Global hotkey doesn't work

Ensure Input Monitoring permission is granted
Check for conflicts with other apps (BetterTouchTool, Alfred, Keyboard Maestro)
Try a different key combination
Restart SuperCmd
Check console logs for registration errors

Command hotkey doesn't trigger

Verify the command ID is correct in settings.json
Ensure the extension is enabled
Check for conflicts with system shortcuts
Try unregistering and re-registering the hotkey

Hyper Key doesn't work

Grant Accessibility permission
Grant Input Monitoring permission
Restart SuperCmd after granting permissions
Check hyperKeySource keycode is correct
Test with debug mode enabled (Cmd+Option+I)

Shortcuts work inconsistently

This can happen if:

Another app is capturing the same shortcut
macOS Secure Input is enabled (check with Karabiner-Elements EventViewer)
The app is running in the background but not receiving events

Solution: Use more unique shortcuts (e.g., Hyper Key combinations).

Can't use Function keys (F1-F12)

macOS reserves F1-F12 for system functions by default:

Go to System Settings → Keyboard
Enable Use F1, F2, etc. keys as standard function keys
Or use Fn+F1 in shortcuts

Next Steps

Settings

All configuration options

Permissions

Required macOS permissions

Extensions

Install and manage extensions

Window Management

Use window tiling hotkeys

Get Started

Core Features

Configuration

Extensions

Overview

Global Launcher Hotkey

Per-Command Hotkeys

Setting Up Command Hotkeys

Command ID Format

Finding Command IDs

Hyper Key

Use Cases

Setup

Hyper Key Settings

How It Works

In-App Shortcuts

Global Navigation

Search & Filtering

List & Grid Views

Form Views

Extension Shortcuts

Shortcut Format

Conflict Detection

Troubleshooting

Next Steps

Settings

Permissions

Extensions

Window Management

Build docs developers (and LLMs) love

Get Started

Core Features

Configuration

Extensions

​Overview

​Global Launcher Hotkey

​Per-Command Hotkeys

​Setting Up Command Hotkeys

​Command ID Format

​Finding Command IDs

​Hyper Key

​Use Cases

​Setup

​Hyper Key Settings

​How It Works

​In-App Shortcuts

​Global Navigation

​Search & Filtering

​List & Grid Views

​Form Views

​Extension Shortcuts

​Shortcut Format

​Conflict Detection

​Troubleshooting

​Next Steps

Settings

Permissions

Extensions

Window Management

Build docs developers (and LLMs) love

Overview

Global Launcher Hotkey

Per-Command Hotkeys

Setting Up Command Hotkeys

Command ID Format

Finding Command IDs

Hyper Key

Use Cases

Setup

Hyper Key Settings

How It Works

In-App Shortcuts

Global Navigation

Search & Filtering

List & Grid Views

Form Views

Extension Shortcuts

Shortcut Format

Conflict Detection

Troubleshooting

Next Steps