Skip to main content

​
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
​
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

Build docs developers (and LLMs) love

Get started for freeTalk to us