Skip to main content

​
Download SuperCmd

SuperCmd is currently available for macOS only (both Apple Silicon and Intel).

Apple Silicon (M1/M2/M3/M4)

Download SuperCmd-x.x.x-arm64.dmg

Intel Mac

Download SuperCmd-x.x.x.dmg
Latest version: v1.0.5 — Check the releases page for the most recent build.

​
Install the App

1

Open the DMG file

Double-click the downloaded .dmg file to mount the disk image.
2

Drag to Applications

Drag the SuperCmd app icon into your Applications folder.
3

Launch SuperCmd

Open SuperCmd from your Applications folder or Spotlight.

​
Handle macOS Security Warnings

On first launch, macOS may display a security warning because SuperCmd is not notarized by Apple (yet).
“SuperCmd cannot be opened because it is from an unidentified developer”This is expected for open-source apps distributed outside the Mac App Store.

​
How to bypass the warning

1

Open System Settings

Go to System Settings → Privacy & Security
2

Find the blocked app

Scroll down to the Security section. You should see:
“SuperCmd was blocked from use because it is not from an identified developer.”
3

Click 'Open Anyway'

Click the Open Anyway button next to the message.You may need to authenticate with Touch ID or your password.
4

Confirm

Click Open in the confirmation dialog.
You only need to do this once. After the first launch, macOS will remember your choice.

​
Grant Required Permissions

SuperCmd needs several macOS permissions to function properly. The app will prompt you on first use, or you can enable them manually.

​
Required Permissions

Why: Enables window management, keystroke injection for snippet expansionRequired for:
  • Window tiling and positioning
  • Snippet expansion
  • Script commands that manipulate windows
How to enable:
  1. Open System Settings → Privacy & Security → Accessibility
  2. Find SuperCmd in the list
  3. Toggle it on
  4. Restart SuperCmd
If SuperCmd is not in the list, click the + button and navigate to /Applications/SuperCmd.app.
Why: Detects global hotkeys (launcher shortcut, hold-to-speak)Required for:
  • Core launcher functionality (default: Cmd + Space)
  • Voice input hotkey (hold to speak)
  • Custom keyboard shortcuts
How to enable:
  1. Open System Settings → Privacy & Security → Input Monitoring
  2. Find SuperCmd in the list
  3. Toggle it on
  4. Restart SuperCmd
Without this permission, the launcher will not respond to keyboard shortcuts.
Why: Voice dictation (speech-to-text)Required for:
  • Hold-to-speak voice input
  • Voice commands
  • Wispr Flow-style dictation
How to enable:
  1. Open System Settings → Privacy & Security → Microphone
  2. Find SuperCmd in the list
  3. Toggle it on
Only required if you plan to use voice features. You can skip this if you prefer keyboard-only input.
Why: Selected text capture, system automation, extension actionsRequired for:
  • Capturing selected text from other apps
  • Running AppleScript-based extensions
  • Automating macOS system features
How to enable:
  1. Open System Settings → Privacy & Security → Automation
  2. Find SuperCmd in the list
  3. Enable automation for the apps you want SuperCmd to control (e.g., Finder, Safari)
SuperCmd will prompt you for automation access when you first try to use a feature that requires it.

​
Permission Summary Table

PermissionStatusWhyRequired for
AccessibilityRequiredWindow management, keystroke injectionWindow tiling, snippet expansion
Input MonitoringRequiredGlobal hotkey detectionCore launcher functionality
MicrophoneOptionalVoice dictation (speech-to-text)Voice features
AutomationOptionalSelected text capture, system automationExtension actions
Important: You may need to restart SuperCmd after granting permissions for changes to take effect.

​
First Launch Configuration

1

Open SuperCmd

Press Cmd + Space (default hotkey) or click the menu bar icon.
2

Complete the onboarding

SuperCmd will guide you through:
  • Setting your preferred hotkey
  • Granting necessary permissions
  • Choosing default settings
3

Test the launcher

Type a command to search:
  • Applications (e.g., “Safari”, “Chrome”)
  • System preferences
  • Built-in commands

​
Auto-Updates

SuperCmd includes a built-in auto-updater powered by electron-updater.

Automatic Updates

SuperCmd checks for updates on launch and downloads them in the background.

Manual Check

Search for “Check for Updates” in the launcher to manually check.
Updates are downloaded and installed automatically. You’ll be prompted to restart when a new version is ready.

​
Verify Installation

To confirm SuperCmd is installed correctly:
1

Check the version

Open SuperCmd and search for “About SuperCmd”You should see version 1.0.5 (or later).
2

Test permissions

  • Press your global hotkey (Cmd + Space) — the launcher should appear
  • Try typing a command — results should filter as you type
  • Open Settings → check that all permissions show as granted
3

Install a test extension

Search for “Store” in the launcher, browse available extensions, and install one to verify the extension runtime works.

​
Troubleshooting

Solution:
  1. Check that Input Monitoring permission is enabled
  2. Restart SuperCmd
  3. Try changing the global hotkey in Settings → General
  4. Make sure no other app is using the same shortcut (e.g., Spotlight, Raycast)
Solution:
  1. Verify Accessibility permission is granted
  2. The Swift binary window-adjust.swift checks AXIsProcessTrusted()
  3. Restart SuperCmd after enabling Accessibility
Solution:
  1. Verify Homebrew is installed (brew --version)
  2. SuperCmd uses Homebrew-resolved git to clone extensions from GitHub
  3. Check your internet connection
  4. Try manually running: git clone https://github.com/raycast/extensions.git
Solution:
  1. Grant Microphone permission
  2. Check that your microphone is working in other apps
  3. Verify the microphone is selected in System Settings → Sound → Input
Solution:
  1. Check the logs: ~/Library/Logs/SuperCmd/main.log
  2. Try deleting settings: rm -rf ~/Library/Application\ Support/SuperCmd/
  3. Reinstall SuperCmd from a fresh download
  4. Report the issue on GitHub Issues

Still having issues?

Join our Discord community for real-time support

​
Next Steps

Now that SuperCmd is installed, learn the basics:

Quick Start Guide

Run your first command and explore core features

Configure AI Providers

Set up OpenAI, Claude, or Ollama

Install Extensions

Browse and install Raycast extensions

Customize Hotkeys

Set up your preferred keyboard shortcuts

Build docs developers (and LLMs) love

Get started for freeTalk to us