SuperCmd

Raycast + Wispr Flow + Speechify + Memory + AI

Open-source launcher for macOS with Raycast-compatible extensions, voice workflows, and AI-native actions.

Open-source launcher for macOS: Raycast + Wispr Flow + Speechify + Memory + AI in one app.

SuperCmd gives you Raycast-style extension workflows, hold-to-speak dictation, natural text-to-speech, AI actions backed by configurable providers and memory, notes, canvas, clipboard history, snippet expansion, and window tiling — all from a single keyboard shortcut.

What It Is

SuperCmd is an Electron + React launcher that focuses on Raycast extension compatibility while remaining community-driven and open source. It ships a full @raycast/api and @raycast/utils compatibility shim so existing Raycast extensions work without modification. For anything that requires tight system integration — hotkeys, window management, speech recognition, clipboard, snippet injection — it drops into Swift and Objective-C to talk directly to macOS frameworks (ApplicationServices, EventKit, AVFoundation, Carbon) for native speed and reliability.

Key Features

• Raycast extension compatibility — @raycast/api and @raycast/utils shims; install extensions directly from the Raycast store
• Raycast backup import — import encrypted .rayconfig backups with settings, hotkeys, extensions, scripts, quicklinks, snippets, notes, and extension prefs
• AI cursor prompt — inline AI suggestions at your cursor position across any app
• AI chat — chat with configurable providers (OpenAI / Anthropic / Ollama / Gemini / OpenAI-compatible)
• Hold-to-speak dictation — Wispr Flow-style voice input; hold hotkey, speak, release to type (Whisper, Parakeet, or native macOS STT)
• Read aloud — Speechify-style TTS for selected text (Edge TTS or ElevenLabs)
• Clipboard history — full clipboard manager with Cmd+1–9 quick-paste shortcuts
• Snippet expansion — create and trigger text snippets with keyboard shortcuts
• Quick links — bookmark URLs and launch them from the launcher
• Notes — lightweight in-launcher note-taking
• Canvas — freeform drawing and diagramming
• File search — fast indexed file search with protected-roots support
• Calendar/schedule — view today's events from EventKit
• Window tiling — 24 window placement commands (halves, thirds, quarters, center, fill, 10px nudge/resize)
• Hyper key — remap Caps Lock to a custom modifier with configurable behavior
• System commands — Sleep, Restart, Lock Screen, Log Out, Close All Apps, Empty Trash
• Script command support — run custom shell/Python/Ruby scripts from the launcher
• Auto-updates — built-in updater via GitHub Releases; check manually or install on next launch
• Memory-aware AI — Supermemory integration
• Glassy UI — liquid-glass morphism with custom background image, blur, and opacity controls
• Localization — English, Chinese (Simplified/Traditional), Japanese, Korean, French, German, Spanish, Russian

Tech Stack

• Electron 40 (main process)
• React 18 + Vite 5 (renderer)
• TypeScript 5.3
• Tailwind CSS 3
• Swift binaries for macOS-native integrations (11 Swift helpers + fast-paste native module)

Project Structure

src/main/        Electron main process, IPC, extension execution, AI, settings
src/renderer/    React UI + Raycast compatibility layer + built-in feature views
src/native/      Swift native helpers (11 binaries)
extensions/      Installed/managed extension data
dist/            Build output

Key source files

Native Swift helpers

Install

Homebrew

brew install --cask supercmdlabs/supercmd/supercmd

Download the app

Download the latest .dmg from the Releases page:

• Apple Silicon (M1/M2/M3/M4): SuperCmd-x.x.x-arm64.dmg
• Intel Mac: SuperCmd-x.x.x.dmg

Open the .dmg, drag SuperCmd to your Applications folder, and launch it.

Note: On first launch, macOS may warn that the app is from an unidentified developer. Go to System Settings → Privacy & Security and click "Open Anyway".

macOS Permissions

SuperCmd needs the following permissions. The app will prompt you on first use, or you can enable them manually in System Settings → Privacy & Security:

You may need to restart the app after granting permissions.

Auto-updates

SuperCmd includes a built-in auto-updater backed by GitHub Releases. You can check for updates manually by searching "Check for Updates" in the launcher, or install a downloaded update on next launch.

Raycast Backup Import

SuperCmd can import encrypted Raycast .rayconfig backups from the General settings tab.

It currently imports: - Raycast settings that map cleanly to SuperCmd - the global launcher hotkey - command hotkeys - quicklinks - snippets - notes - installed Raycast extensions - extension preferences - script command folders - disabled script commands - disabled extension commands

It intentionally skips or only partially maps: - AI chats - clipboard history - MCP server config - Raycast aliases, where the backup does not expose a clean first-class field

The importer decrypts backups locally and prompts for the backup password before reading the file.

Development Setup

Prerequisites

• macOS (required — native Swift modules won't compile on Linux/Windows)
• Node.js 22+ — check with node -v
• npm — comes with Node.js
• Xcode Command Line Tools — required for swiftc (Swift compiler)
• Homebrew — used at runtime to resolve git and npm for extension installation

1. Install system dependencies

If you don't have Xcode Command Line Tools:

xcode-select --install

Verify Swift is available:

swiftc --version

If you don't have Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Clone and install

git clone https://github.com/SuperCmdLabs/SuperCmd.git
cd SuperCmd
npm install

3. Build native modules

The dev script does not compile the Swift native helpers — build them once before your first run:

npm run build:native

This compiles all Swift binaries and native Node modules into dist/native/.

4. Run in development mode

npm run dev

This starts TypeScript watch for the main process, the Vite dev server for the renderer, and Electron in development mode.

5. Build for production

npm run build

Runs build:main + build:renderer + build:native in sequence.

6. Package the app

npm run package

Output artifacts are generated under out/.

Useful Commands

npm run dev              # Start local development (watch + Vite + Electron)
npm run build            # Build main, renderer, and native modules
npm run build:main       # Compile Electron main process TypeScript
npm run build:renderer   # Build renderer with Vite
npm run build:native     # Compile Swift helpers and native modules
npm run package          # Build and package app with electron-builder
npm run package:unsigned # Build unsigned package for local testing
npm run check:i18n       # Check internationalization strings

Troubleshooting

AI + Memory Setup

Configure everything from the app UI:

1. Launch SuperCmd.
2. Open Settings (search "Settings" or use the gear icon).
3. Go to the AI tab.
4. Enable AI (enabled = true).
5. Pick your default provider and add the required key(s).

Providers

Speech / voice keys

Memory keys

Where settings are stored

All app settings are persisted in:

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

Key fields:

{
  "globalShortcut": "Alt+Space",
  "openAtLogin": false,
  "uiStyle": "glassy",
  "fontSize": "medium",
  "appLanguage": "system",
  "ai": {
    "enabled": true,
    "provider": "openai",
    "openaiApiKey": "",
    "anthropicApiKey": "",
    "geminiApiKey": "",
    "ollamaBaseUrl": "http://localhost:11434",
    "elevenlabsApiKey": "",
    "supermemoryApiKey": "",
    "supermemoryBaseUrl": "https://api.supermemory.ai",
    "defaultModel": "openai-gpt-4o-mini",
    "speechToTextModel": "native",
    "textToSpeechModel": "edge-tts"
  }
}

OAuth tokens are stored separately in ~/Library/Application Support/SuperCmd/oauth-tokens.json.

Optional environment variable fallbacks

• ELEVENLABS_API_KEY
• SUPERMEMORY_API_KEY
• `SUPE