Settings

Configure SuperCmd’s appearance, behavior, and integrations

Overview

SuperCmd stores all settings in a JSON file at:

~/Library/Application Support/SuperCmd/settings.json

You can configure SuperCmd through the Settings window (search for “Settings” in the launcher) or by editing the settings file directly.

General Settings

Global Shortcut

globalShortcut · string · default: "Alt+Space"

The keyboard shortcut to open SuperCmd from anywhere in macOS.

Popular alternatives:

• Command+Space (requires disabling Spotlight)
• Option+Space (Alt+Space)
• Control+Space
• Command+Shift+Space

Launch at Login

openAtLogin · boolean · default: "false"

Automatically start SuperCmd when you log in to macOS.

Font Size

fontSize · string · default: "medium"

Choose from: extra-small, small, medium, large, extra-large

UI Style

uiStyle · string · default: "default"

Choose between default or glassy (translucent window with blur effect)

Base Color

baseColor · string · default: ""

Customize the accent color for the UI (hex color code)

Commands & Extensions

Disabled Commands

disabledCommands · string[] · default: "[]"

Array of command IDs to hide from the launcher

Enabled Commands

enabledCommands · string[] · default: "[]"

Whitelist of command IDs (if set, only these commands are shown)

Custom Extension Folders

customExtensionFolders · string[] · default: "[]"

Additional directories to scan for extensions

{
  "customExtensionFolders": [
    "/Users/yourname/my-extensions",
    "/Users/yourname/raycast-extensions"
  ]
}

Command Hotkeys

commandHotkeys · Record<string, string> · default: "{}"

Map command IDs to global keyboard shortcuts

{
  "commandHotkeys": {
    "clipboard-history": "Command+Shift+V",
    "window-management": "Control+Option+W"
  }
}

Command Aliases

commandAliases · Record<string, string> · default: "{}"

Custom search terms for commands

{
  "commandAliases": {
    "com.extension.command-id": "shortcut alias"
  }
}

Pinned & Recent Commands

pinnedCommands · string[] · default: "[]"

Command IDs that always appear at the top of the launcher

recentCommands · string[] · default: "[]"

Recently used commands (auto-managed)

recentCommandLaunchCounts · Record<string, number> · default: "{}"

Launch count for frecency sorting (auto-managed)

AI Settings

See AI Providers for detailed AI configuration.

ai.enabled · boolean · default: "true"

Master switch for all AI features

ai.llmEnabled · boolean · default: "true"

Enable AI chat and inline prompts

ai.whisperEnabled · boolean · default: "true"

Enable voice input (speech-to-text)

ai.readEnabled · boolean · default: "true"

Enable text-to-speech (read aloud)

ai.provider · string · default: "openai"

Default AI provider: openai, anthropic, gemini, ollama, openai-compatible

Hyper Key

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

hyperKeySource · number | null · default: "null"

Keycode of the source key to remap (e.g., Caps Lock = 57, Right Option = 61)

hyperKeyIncludeShift · boolean · default: "false"

Include Shift in the Hyper Key combination

hyperKeyQuickPressAction · string · default: "toggle-caps-lock"

Action when Hyper Key is pressed and released quickly: toggle-caps-lock, escape, none

hyperReplaceModifierGlyphsWithHyper · boolean · default: "false"

Show ”⌘⌥⌃⇧” as “⌘Hyper” in shortcut badges

File Search

fileSearchProtectedRootsEnabled · boolean · default: "false"

Allow file search in protected system directories

Enabling file search in protected directories may expose sensitive system files.

Debug Mode

debugMode · boolean · default: "false"

Enable verbose logging in the console

Open DevTools with Cmd+Option+I when debug mode is enabled.

Onboarding

hasSeenOnboarding · boolean · default: "false"

Whether the user has completed the initial onboarding

hasSeenWhisperOnboarding · boolean · default: "false"

Whether the user has completed the Whisper voice input onboarding

Auto-Updates

appUpdaterLastCheckedAt · number · default: "0"

Timestamp of the last update check (milliseconds since epoch)

SuperCmd automatically checks for updates using electron-updater. You can manually check for updates by searching for “Check for Updates” in the launcher.

Command Metadata

commandMetadata · Record<string, { subtitle?: string }> · default: "{}"

Custom subtitles for commands (set via updateCommandMetadata() API)

{
  "commandMetadata": {
    "com.example.command": {
      "subtitle": "Custom subtitle text"
    }
  }
}

Settings File Location

You can manually edit the settings file while SuperCmd is closed:

open ~/Library/Application\ Support/SuperCmd/settings.json

Always close SuperCmd before manually editing settings.json to avoid data loss.

Resetting Settings

To reset all settings to defaults:

1. Quit SuperCmd

   Right-click the menu bar icon and select Quit

2. Delete settings file

   rm ~/Library/Application\ Support/SuperCmd/settings.json
   
3. Restart SuperCmd

   Launch SuperCmd from Applications folder

Next Steps

Permissions

Configure macOS permissions

AI Providers

Set up AI integrations

Hotkeys

Customize keyboard shortcuts

Extensions

Install and manage extensions