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.

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.

• Raycast extension compatibility — @raycast/api and @raycast/utils shims; install extensions directly from the Raycast store
• 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

• 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)

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

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".

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.

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.

• 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

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)"

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

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/.

npm run dev

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

npm run build

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

npm run package

Output artifacts are generated under out/.

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

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).

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.

• ELEVENLABS_API_KEY
• SUPERMEMORY_API_KEY
• SUPERMEMORY_CLIENT
• SUPERMEMORY_BASE_URL
• SUPERMEMORY_LOCAL

SuperCmd is open-source, so you can audit exactly what it does. The short version:

• Telemetry: one anonymous app_started event via Aptabase.
• AI prompts: sent directly from your device to your configured provider (OpenAI / Anthropic / Gemini / Ollama).
• Extension install/uninstall: reports extension name + an anonymous random machine ID to api.supercmd.sh for download counts.
• Voice data: STT runs fully on-device (Whisper, Parakeet, native macOS) — audio never leaves your machine.

See SECURITY.md for the full breakdown.

We welcome contributions! See CONTRIBUTING.md for detailed guidelines on development setup, code architecture, PR conventions, and more.

Quick version:

1. Fork the repo and create a feature branch.
2. Make your changes, keeping Raycast extension compatibility in mind.
3. Run npm run build to verify.
4. Open a PR with a clear description of what, why, and how you tested.

• Raycast API docs: https://developers.raycast.com/api-reference/
• Raycast extension store: https://www.raycast.com/store

Thanks to everyone who has contributed to SuperCmd!