AIBit-Discover Open Source Projects AIBit-Discover Open Source Projects

SuperCmd: All-in-One macOS Launcher with Voice AI

SuperCmd brings together Raycast extensions, Wispr Flow voice dictation, Speechify read‑aloud, and AI actions into one unified macOS app. Learn how to install, configure AI providers, leverage native macOS helpers, and extend SuperCmd with your own scripts or Raycast extensions. Whether you’re a productivity enthusiast or an open‑source contributor, this guide covers the setup, workflow, and development roadmap so you can jump straight into boosting your daily workflow with smart AI automation.

What Is SuperCmd?

SuperCmd is an open‑source Electron + React launcher built for macOS that fuses the best parts of Raycast, Wispr Flow, Speechify, and modern AI services. It replaces a dozen separate apps—command palettes, dictation drivers, TTS readers, and AI chat windows—into a single, unified interface that runs in its own window but behaves like a system‑level helper.

Why you’ll love it

  • Runs natively on macOS (Swift helpers keep everything snappy)
  • Full Raycast‑extension compatibility: install any Raycast plugin without leaving SuperCmd
  • Voice‑first workflow: hold‑to‑speak dictation and press‑to‑type TTS read‑aloud
  • AI actions that remember context via Supermemory and can use OpenAI, Anthropic, Ollama, or ElevenLabs for speech
  • Built‑in hot‑key shortcuts, color picker, and snippet expansion
  • Open‑source – modify, extend, or remix to suit your workflow

Core Features

Feature Description
Raycast Extensions Uses @raycast/api and @raycast/utils shims to load and run any Raycast‑compatible extension. No re‑implementation required.
Wispr Flow Voice Mimics the hold‑to‑speak behavior of Wispr Flow. While you hold a key, your voice is recorded; when you release, the transcribed text is inserted into the focused application.
Speechify Read‑Aloud Hit the read‑aloud hot‑key and SuperCmd will capture the current selection, synthesize speech (Edge‑TTS or ElevenLabs), and play it back in‑window.
AI Actions & Memory Create custom AI actions using a plugin system. Choose a provider, set keys, and let the AI remember context through Supermemory for richer conversations.
Native macOS Helpers Swift binaries give SuperCmd low‑level access to macOS services: speech, hot‑keys, color picking, and snippet expansion.

System Requirements & Prerequisites

Item Minimum requirement
macOS 12 Monterey or newer (Swift modules require a recent SDK)
Node.js 22+
npm 9+
Xcode Command Line Tools xcode-select --install
Homebrew Recommended for optional utilities

Tip: If you only need the UI and extensions, the native Swift layer can be skipped, but the default build includes all helpers.

Installation & Quick Start

# Clone the repo
git clone https://github.com/SuperCmdLabs/SuperCmd.git
cd SuperCmd

# Install dependencies
npm install

# Run in dev mode
npm run dev

The dev script launches the Electron renderer (powered by Vite) and watches for file changes. For a production build run:

npm run build   # Builds main, renderer, and Swift helpers
npm run package # Packages the app into an .app under "/out"

The compiled app is self‑contained and can be distributed or copied to ~/Applications.

Configuring AI and Speech

SuperCmd stores all settings in ~/Library/Application Support/SuperCmd/settings.json. You can also provide credentials via environment variables:

  • ELEVENLABS_API_KEY
  • SUPERMEMORY_API_KEY
  • SUPERMEMORY_CLIENT
  • SUPERMEMORY_BASE_URL
  • SUPERMEMORY_LOCAL

Inside the app:

  1. Open Settings > AI.
  2. Toggle AI on.
  3. Pick a provider:
    • OpenAI – set openaiApiKey and choose `