explaingit

justyannicc/supercmd

1Audience · developerComplexity · 4/5ActiveSetup · moderate

TLDR

Open-source macOS launcher built on Electron and React that runs Raycast extensions, dictation, TTS, AI chat, clipboard history, snippets, and window tiling from one keyboard shortcut.

Mindmap

mindmap
  root((SuperCmd))
    Inputs
      Global hotkey
      Voice dictation
      Raycast extensions
      rayconfig backups
    Outputs
      Typed text
      AI replies
      Window tiling actions
      Clipboard paste
    Use Cases
      Replace Raycast
      Hold-to-speak typing
      AI chat at cursor
      Read selection aloud
    Tech Stack
      Electron
      React
      TypeScript
      Vite
      Tailwind
      Swift

Things people build with this

USE CASE 1

Install on macOS as a Raycast drop-in that still loads existing Raycast extensions

USE CASE 2

Add hold-to-speak voice dictation across any app with Whisper or native macOS STT

USE CASE 3

Run inline AI chat at the cursor against OpenAI, Anthropic, Ollama, or Gemini

USE CASE 4

Manage clipboard history, snippets, and 24 window tiling commands from one launcher

Tech stack

ElectronReactTypeScriptViteTailwindSwift

Getting it running

Difficulty · moderate Time to first run · 30min

macOS only and you must grant Accessibility, Input Monitoring, Microphone, AppleScript Automation, and Calendars permissions before features start working.

In plain English

SuperCmd is an open-source launcher for macOS that the author frames as a single replacement for Raycast, Wispr Flow, Speechify, AI memory tools, and chat assistants. The user opens it with a keyboard shortcut and gets a search bar that runs commands, fires Raycast-style extensions, dictates speech, reads selected text aloud, manages clipboard history, expands snippets, tiles windows, and talks to AI providers. A central design choice is Raycast extension compatibility. SuperCmd ships shims for the @raycast/api and @raycast/utils libraries so existing Raycast extensions install and run without modification, and it can import encrypted .rayconfig backups that bring settings, hotkeys, extensions, scripts, quicklinks, snippets, notes, and extension preferences across. For features that need deep system access, the project drops out of Electron and calls Swift binaries that talk to native macOS frameworks like ApplicationServices, EventKit, AVFoundation, and Carbon. Highlights from the long feature list include hold-to-speak dictation using Whisper, Parakeet, or the native macOS speech engine; text-to-speech through Edge TTS or ElevenLabs; AI chat against OpenAI, Anthropic, Ollama, Gemini, or any OpenAI-compatible endpoint; an inline AI prompt at the cursor; 24 window-placement commands; a Caps Lock to Hyper Key remapper; file search with protected-roots support; calendar events from EventKit; notes; a freeform canvas; and quick-paste via Cmd+1 through Cmd+9. The stack is Electron 40 in the main process, React 18 with Vite 5 in the renderer, TypeScript 5.3, and Tailwind CSS 3, plus 11 Swift helper binaries and a Swift package for on-device speech-to-text. The repository structure separates the Electron main process, the React renderer, and the Swift native helpers. Install is by Homebrew cask or by downloading the latest signed .dmg from the GitHub Releases page, with separate builds for Apple Silicon and Intel. On first launch the app prompts for Accessibility, Input Monitoring, Microphone, AppleScript Automation, and Calendars permissions. The app updates itself through GitHub Releases.

Copy-paste prompts

Prompt 1
Walk me through installing SuperCmd via Homebrew and granting the five macOS permissions it needs on first launch
Prompt 2
Show me how to import my encrypted .rayconfig backup into SuperCmd and which settings carry over
Prompt 3
Explain how SuperCmd's @raycast/api shim runs existing Raycast extensions unmodified
Prompt 4
Help me wire up an Anthropic API key for SuperCmd's AI chat and inline cursor prompt
Prompt 5
List the 11 Swift helper binaries in SuperCmd and which macOS framework each one calls
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.