SuperCmd: A Modern, Open-Source macOS Launcher for the AI-Enhanced Workflow

Open-source launcher for macOS with Raycast-compatible extensions, voice workflows, and AI-native actions. SuperCmd brings together the familiar feel of Raycast, the fluidity of Wispr Flow-style voice input, the clarity of Speechify-style text-to-speech, memory-aware AI, and a host of native-system integrations—all accessible from a single keyboard shortcut. This blog post dives into what SuperCmd is, how it’s built, and how you can run, contribute to, and customize this powerful tool.

Introduction to the project and what makes it unique

• SuperCmd is an Electron + React launcher designed around Raycast extension compatibility. It ships with a compatibility shim for the Raycast API, which means existing Raycast extensions can run with little or no modification.

• Where browser-like extensions meet native macOS integration, SuperCmd drops into Swift and Objective-C for high-speed, reliable access to system features: hotkeys, window management, speech recognition, clipboard handling, and text/script injection.

• This combination yields a powerful, customizable, and community-driven launcher that covers productivity essentials—from quick command execution and clipboard history to AI-assisted text generation and memory-aware AI workflows.

  core identity and design direction

• An emphasis on speed and reliability across both Electron-based UI and native macOS frameworks.

• A glassy, modern UI that stays unobtrusive while offering a broad feature set.

• Localization support and a flexible architecture that invites extension developers and power users alike.

Core Features: A Deep Dive into What SuperCmd Can Do SuperCmd brings a rich feature set designed to streamline daily workflows. Below is a structured tour of the key capabilities, organized to show what a typical power user can expect.

Raycast extension compatibility

• Compatibility shim for the Raycast API (@raycast/api and @raycast/utils).
• Extensions can be installed directly from the Raycast store and run with minimal friction.
• The architecture emphasizes compatibility so you can reuse or port your favorite Raycast workflows with ease.

AI-powered experiences and prompts

• AI cursor prompts: inline AI suggestions appear at your cursor position across any app, accelerating writing, coding, and research.
• AI chat: configure providers (OpenAI, Anthropic, Ollama, Gemini, and OpenAI-compatible services) to suit your preferred model and workflow.
• Memory-aware AI: a memory subsystem (Supermemory) that can underpin context-aware conversations and long-running tasks.

Voice, speech, and text-to-speech

• Hold-to-speak dictation (Wispr Flow-style): press and hold a hotkey, speak, and release to have your words typed automatically (STT via Whisper, Parakeet, or native macOS).
• Read aloud (Speechify-style TTS): convert selected text to speech with configurable voice options (Edge TTS or ElevenLabs in supported configurations).
• Local-first voice processing ensures privacy by default; STT can stay on-device where possible.

Clipboard and note capabilities

• Clipboard history: a full clipboard manager with quick-paste shortcuts (Cmd+1 through Cmd+9 can paste saved items instantly).
• Snippet expansion: create and trigger text snippets via keyboard shortcuts for common phrases, templates, or boilerplate.
• Notes: lightweight in-launcher note-taking to jot down quick ideas or reminders.

Productivity boosters and workflow features

• Quick links: bookmark URLs and launch them directly from the launcher for fast access to your most-used sites.
• Files search: fast indexed file search with protections around critical roots to reduce risk.
• Calendar/schedule: view today’s events via EventKit integration for a quick glance at your day.
• Canvas: freeform drawing and diagramming inside the launcher to visualize ideas and flows.
• Window tiling: 24 window placement commands, including halves, thirds, quarters, center, fill, and precise nudging/resizing.
• Hyper key: Caps Lock remapped to a configurable modifier with user-defined behavior.
• System commands: sleep, restart, lock screen, log out, close all apps, and empty trash—accessible from the launcher to speed up system actions.
• Script command support: run custom shell, Python, or Ruby scripts from within the launcher for automation.
• Auto-updates: built-in updater using GitHub Releases; manual checks or automatic updates on next launch.

Memory, AI, and user experience

• AI memory integration: keep context across interactions to create a more natural and uninterrupted experience.
• Glassy UI: a liquid-glass morphism aesthetic with background image, blur, and opacity controls to fit various environments.
• Localization: English, Chinese (Simplified/Traditional), Japanese, Korean, French, German, Spanish, and Russian to support a global audience.

Tech Stack: How SuperCmd Is Built SuperCmd blends modern web technologies with native macOS capabilities to deliver speed, flexibility, and extensibility.

• Electron 40: main process provides the bridge between the UI and native capabilities.
• React 18 + Vite 5: the renderer layer delivers a fast, modern UI experience.
• TypeScript 5.3: strong typing to reduce runtime errors and improve maintainability.
• Tailwind CSS 3: streamlined styling with a utility-first approach for rapid UI development.
• Native Swift binaries: 11 Swift helpers + a fast-paste native module for tight macOS integration.
• Raycast compatibility layer: ensures a smooth developer experience for extension authors who already target Raycast.

Project Structure: How the Codebase Is Organized SuperCmd’s codebase is split across several layers, each serving a specific purpose:

• src/main
• Electron main process, IPC, extension execution, AI, and settings.
• src/renderer
• React UI, Raycast compatibility layer, and built-in feature views.
• src/native
• 11 binaries providing macOS-native helpers (Swift-based).
• extensions
• Installed and managed extension data.
• dist
• Build output ready for packaging.
• Key source files (high-level overview)
• src/main/main.ts: Entry point for the main process; IPC handlers and window management.
• src/main/preload.ts: Exposes a secure window.electron API to the renderer (via contextBridge).
• src/main/commands.ts: Discovers app/extension/script commands with caching.
• src/main/extension-runner.ts: Extension execution engine (esbuild bundle + require shim).
• src/main/extension-registry.ts: Catalogs extensions, handles install/uninstall/update.
• src/main/ai-provider.ts: AI streaming via OpenAI, Anthropic, Ollama, Gemini.
• src/main/settings-store.ts: JSON-based settings persistence.
• src/renderer/src/App.tsx: Root component wiring up hooks and routes.
• src/renderer/src/raycast-api/: Compatibility runtime for Raycast API.
• src/renderer/src/hooks/: Feature hooks that contain state/logic (no JSX).
• src/renderer/src/views/: Full UI views (full-screen components).

Native Swift helpers: A Snapshot The following Swift binaries enable native capabilities, ensuring performance and reliability when interacting with macOS:

• calendar-events: EventKit calendar integration.
• color-picker: System color picker.
• get-selected-text: Extracts selected text from the frontmost app.
• hotkey-hold-monitor: Hold-to-speak hotkey detection.
• hyper-key-monitor: Caps Lock remapping to a custom modifier.
• input-monitoring-request: Request Input Monitoring permission.
• microphone-access: Microphone permission checks.
• snippet-expander: Keyboard-triggered snippet expansion.
• speech-recognizer: macOS-native speech recognition.
• whisper-transcriber: OpenAI Whisper STT integration.
• window-adjust: Window tiling and resizing (ApplicationServices).
• fast-paste-addon: Native module for fast clipboard paste (Cmd+1–9).
• parakeet-transcriber: On-device STT via swift-transformers.

Install and Getting Started: A Practical Guide Downloading and starting up SuperCmd is designed to be straightforward while offering guidance on macOS permissions and updates.

• 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
• Install by dragging SuperCmd to the Applications folder and launching it.
• On first launch, macOS may warn about unidentified developers. If so, go to System Settings → Privacy & Security → Open Anyway.
• Permissions you may need:
• Accessibility: for window tiling and keystroke injection
• Input Monitoring: for global hotkeys (hold-to-speak, launcher shortcut, hyper key)
• Microphone: if you use voice features
• Automation (AppleScript): for selected text capture and automation
• Calendars: optional for reading today’s events
• Auto-updates: SuperCmd uses a built-in updater via GitHub Releases. You can manually check for updates or allow the next launch to install.

Development Setup: From Cloning to Packaging For developers who want to contribute, SuperCmd provides a structured workflow to build and test locally.

Prerequisites

• macOS (native Swift modules require macOS)
• Node.js 22+ (check with node -v)
• npm (comes with Node.js)
• Xcode Command Line Tools (for swiftc)
• Homebrew (to resolve git and npm for extension installation)

Step-by-step setup 1) Install system dependencies

• If needed: xcode-select --install
• Verify Swift: swiftc --version
• Install Homebrew if missing

2) Clone and install

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

3) Build native Swift helpers

• npm run build:native
• This compiles Swift binaries and native modules into dist/native/

4) Run in development mode

• npm run dev
• This starts TypeScript watch for the main process, the Vite renderer, and Electron in dev mode.

5) Build for production

• npm run build
• This runs build:main, build:renderer, and build:native in sequence.

6) Package the app

• npm run package
• Artifacts appear under out/

Useful commands you’ll likely use

• npm run dev: Start local development
• npm run build:main / build:renderer / build:native
• npm run package: Package app with electron-builder
• npm run check:i18n: Validate internationalization strings

Troubleshooting common issues

• swiftc: command not found — Install Xcode Command Line Tools and restart.
• npm install fails on native modules — Ensure CLT are up to date; try updating with softwareupdate --install -a.
• Hotkeys not working — Grant Input Monitoring permission and restart.
• Window management not working — Provide Accessibility permission (AXIsProcessTrusted checks).
• Extensions fail to install — Ensure Homebrew is installed and git is brew-resolved.
• Native features missing in dev — Run npm run build:native first.

AI + Memory Setup: Configuring Providers and Memory SuperCmd’s AI features are designed to be customizable, letting you select providers, keys, and memory behavior from a central settings page.

How to configure 1) Launch SuperCmd. 2) Open Settings (gear icon or search). 3) Navigate to the AI tab. 4) Enable AI (enabled = true). 5) Choose your default provider and supply required keys.

Providers and corresponding settings

• OpenAI: openaiApiKey (GPT-4o, GPT-4o-mini, etc.)
• Anthropic (Claude): anthropicApiKey
• Google Gemini: geminiApiKey
• Ollama: ollamaBaseUrl (default http://localhost:11434 for local models)
• OpenAI-compatible: openaiCompatibleBaseUrl + openaiCompatibleApiKey

Speech/Voice keys

• ElevenLabs: elevenlabsApiKey
• Edge TTS: built-in; no key required
• macOS STT: on-device solutions; no key required
• Whisper STT: local; no key required
• Parakeet STT: local on-device via swift-transformers

Memory-related keys

• supermemoryApiKey: memory API key
• supermemoryClient: memory client ID
• supermemoryBaseUrl: base URL (default: https://api.supermemory.ai)
• supermemoryLocalMode: use a local Supermemory instance

Where settings are stored

• Settings: ~/Library/Application Support/SuperCmd/settings.json
• OAuth tokens: ~/Library/Application Support/SuperCmd/oauth-tokens.json
• Sample JSON structure provides a snapshot of how AI and memory settings are organized

Optional environment variable fallbacks

• ELEVENLABSAPIKEY
• SUPERMEMORYAPIKEY
• SUPERMEMORY_CLIENT
• SUPERMEMORYBASEURL
• SUPERMEMORY_LOCAL

Privacy & Security: What Happens with Your Data SuperCmd is open-source, so you can audit its behavior. The project’s privacy stance is straightforward and designed to minimize data leakage while enabling powerful features.

Telemetry

• Anonymous app_started events are sent to Aptabase to help the project understand usage patterns and stability.

AI prompts

• AI prompts are sent directly from your device to your chosen provider. No data is reshaped or relayed through a server you don’t control by default.

Extensions

• When you install or uninstall extensions, SuperCmd reports the extension name and an anonymous machine ID to api.supercmd.sh for download counts.

Voice data

• STT runs on-device (Whisper, Parakeet, or native macOS) whenever possible, ensuring audio content remains on your machine.

• For full breakdown and detailed security notes, see the SECURITY.md file in the repository.

Contributing: How You Can Help SuperCmd welcomes contributions from developers and researchers who want to improve the project or adapt it to new environments.

• Fork the repository and create a feature branch.
• Implement your changes with Raycast extension compatibility in mind.
• Run npm run build to verify your changes.
• Open a PR with a clear description of what was changed, why, and how you tested.

References: Useful Reading and Resources

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

Contributors and Community

• SuperCmd’s contributor list highlights a diverse group of developers. The project recognizes and appreciates all contributors, including:
• shobhit99
• monotykamary
• elicep01
• tuanddd
• stephaneRR
• ericmason
• pablopunk
• Hantok
• dardevelin
• The project also features a GitHub Star History badge to showcase community momentum.

Why SuperCmd Is Worth Exploring

• If you crave Raycast-like extensions with the power of native macOS integrations, SuperCmd provides a compelling, open-source alternative that blends web technologies with system-native performance.
• Its architecture makes room for both rapid workflows (AI prompts, quick commands, and snippets) and longer-term capabilities (memory-enabled AI conversations, scheduled events, and canvas-based diagrams).
• The design philosophy emphasizes privacy, on-device processing where feasible, and clear, auditable data flows.

Practical Tips for New Users

• Start by enabling the AI features in Settings and choosing a provider you’re comfortable with.
• Enable accessibility and input monitoring early on to unlock window tiling, hotkeys, and the hold-to-speak workflow.
• Explore the clipboard history and snippet expansion to speed up repetitive tasks.
• Use the canvas to sketch out quick diagrams when planning automations or data flows.
• Regularly check for updates to keep native Swift binaries aligned with the latest macOS capabilities.

Closing Thoughts SuperCmd represents a thoughtful synthesis of the best ideas from Raycast, Wispr, Speechify, and memory-driven AI into a single, extensible macOS launcher. It’s designed to be fast, reliable, and adaptable for both individual power users and a broader development community. Whether you’re automating repetitive tasks, prototyping AI-driven prompts, or simply looking for a more streamlined way to access your tools, SuperCmd offers a robust foundation to sharpen your productivity.

Images

• Logo:
• Screenshot:

If you’d like, I can tailor this blog post to emphasize a particular audience (developers, power users, productivity enthusiasts) or expand any section with deeper technical details, walkthroughs, or use-case scenarios.