SuperCmd: The Open-Source Mac Launcher Killing Raycast's Paywall
What if the most powerful macOS launcher you've never heard of was hiding in plain sight? While thousands of developers shell out monthly for Raycast Pro, a small team of open-source rebels quietly built something radical: a launcher that runs Raycast's own extensions, adds AI memory and voice workflows, and costs exactly zero dollars. Meet SuperCmd — the launcher that might make you cancel your subscription before you finish this article.
The Problem: Launchers Got Expensive, Then They Got Complicated
Let's be brutally honest. The macOS launcher space has become a graveyard of half-measures and paywalled promises. Alfred was the king for a decade, but its Workflows feel ancient next to modern expectations. Raycast exploded onto the scene with gorgeous UI and developer-friendly extensions — then locked AI features, cloud sync, and advanced integrations behind a $10/month Pro tier. Meanwhile, voice control? That's another app. Clipboard history? Another subscription. Window tiling? Buy a separate tool.
Your menu bar becomes a parking lot of icons. Your wallet weeps. Your productivity? Fragmented across six different ecosystems with six different learning curves.
What if one open-source project swallowed them all?
That's exactly what SuperCmd's creators asked. Their answer is a technical marvel that combines Electron's cross-platform flexibility with Swift's bare-metal macOS performance — and it's already sending shockwaves through developer communities tired of subscription fatigue.
What Is SuperCmd? The Technical Breakdown
SuperCmd is an open-source macOS launcher built on Electron 40 + React 18 + TypeScript 5.3, with a critical twist: it ships a complete compatibility shim for Raycast's extension API. This means the thousands of extensions in the Raycast Store install and run natively — no modifications, no wrapper hacks, no broken functionality.
But here's where it gets genuinely insane. Instead of treating native macOS integration as an afterthought (the typical Electron app trap), SuperCmd drops down to Swift and Objective-C binaries for anything performance-critical:
- ApplicationServices framework for window tiling and keystroke injection
- AVFoundation for speech recognition and text-to-speech
- Carbon for global hotkey capture
- EventKit for calendar integration
- Core Graphics for clipboard operations and color picking
The result? 11 compiled Swift binaries plus a native Node.js module for fast paste operations. You get the development velocity of JavaScript with the raw performance of system-level code where it actually matters.
The project emerged from a simple observation: Raycast's extension ecosystem is genuinely excellent, but its business model creates artificial scarcity. SuperCmd's community-driven approach says "great ideas should be accessible" — and backs it up with code that competes on pure technical merit.
Why it's trending now: The launch coincides with growing developer frustration over AI feature paywalling. SuperCmd ships GPT-4o, Claude 3.5 Sonnet, Gemini 1.5 Pro, and local Ollama support out of the box — no subscription, no "credits," no gatekeeping. Just configure your API key and go.
Key Features: Where SuperCmd Pulls Ahead
Raycast Extension Compatibility (The Secret Weapon)
SuperCmd's @raycast/api and @raycast/utils shims aren't stubs or mocks — they're full runtime implementations that translate Raycast's APIs into SuperCmd's architecture. Extensions think they're running in Raycast. They're actually running in something faster, more customizable, and completely free.
The backup import feature is equally aggressive: drop your encrypted .rayconfig file into SuperCmd, enter your password, and watch your settings, hotkeys, extensions, scripts, quicklinks, snippets, and notes migrate seamlessly. The only things that don't transfer cleanly are Raycast's proprietary AI chats and MCP server configs — because SuperCmd replaces them with something better.
Voice-First Workflows (Wispr Flow + Speechify, No Subscription)
Hold a hotkey. Speak. Release. Text appears. That's Wispr Flow-style dictation powered by your choice of:
- OpenAI Whisper (local, private, accurate)
- Parakeet (on-device via swift-transformers, zero network)
- Native macOS STT (free, fast, Apple's neural engine)
For output, Speechify-style read-aloud uses either Microsoft's free Edge TTS or ElevenLabs' premium voices. Your documents, emails, code comments — anything selected — spoken naturally while you keep working.
AI With Actual Memory
Most "AI integrations" are stateless chat wrappers. SuperCmd integrates Supermemory, giving your AI assistant persistent context across sessions. It remembers your preferences, your project structures, your recurring tasks. Configure it with a simple API key or run entirely local.
The Everything-Else List
- AI cursor prompts — inline suggestions at your actual cursor position, any app
- Clipboard history with
Cmd+1throughCmd+9instant paste - Snippet expansion with keyboard triggers
- Canvas for freeform diagrams and sketches
- 24 window tiling commands (halves, thirds, quarters, nudge, resize)
- Hyper key remapping (Caps Lock becomes a custom modifier)
- File search with protected-roots indexing
- System commands (Sleep, Lock, Empty Trash, Close All Apps)
- Glassy liquid-morphism UI with custom backgrounds and blur controls
- 9-language localization
Use Cases: Where SuperCmd Actually Wins
1. The Frugal Full-Stack Developer
You run 20+ Raycast extensions, use AI daily, and refuse to pay $120/year for features you can self-host. SuperCmd imports your entire Raycast setup in minutes, connects to your existing OpenAI API key (pay-per-use, typically $2-5/month for heavy usage), and runs local Whisper for voice notes. Annual savings: $100+. Feature gain: significant.
2. The Privacy-Paranous Security Engineer
Every keystroke to a cloud AI is a potential data leak. SuperCmd's Parakeet STT runs entirely on-device via swift-transformers. Ollama integration means your code never hits OpenAI's servers. Clipboard history stays local. The only telemetry? One anonymous app_started event. You can audit every line — it's open source.
3. The Multitasking Productivity Nerd
Morning standup: hold Alt+Space, speak your update, release — Whisper transcribes it into Slack. Afternoon code review: select a complex function, hit read-aloud — ElevenLabs narrates while you walk around. End of day: canvas diagram for tomorrow's architecture review, window-tiled beside your notes. One shortcut. One ecosystem. Zero context switching.
4. The Raycast Extension Builder
Test your extensions in a second runtime without breaking your primary workflow. SuperCmd's compatibility shim surfaces edge cases Raycast might miss. Plus, your extensions reach users who've abandoned Raycast's paywall — a growing market of motivated, technical users.
Step-by-Step Installation & Setup Guide
Method 1: Homebrew (Fastest)
# Add the tap and install in one command
brew install --cask supercmdlabs/supercmd/supercmd
Method 2: Manual DMG Download
Grab the latest release from GitHub Releases:
| Architecture | File Pattern |
|---|---|
| Apple Silicon (M1/M2/M3/M4) | SuperCmd-x.x.x-arm64.dmg |
| Intel Mac | SuperCmd-x.x.x.dmg |
Drag to Applications, launch, and approve the security prompt at System Settings → Privacy & Security → Open Anyway.
Critical: Grant These Permissions
SuperCmd will prompt you, but enabling everything upfront prevents frustration:
| Permission | Path | Required For |
|---|---|---|
| Accessibility | Privacy & Security → Accessibility | Window tiling, snippet injection |
| Input Monitoring | Privacy & Security → Input Monitoring | Global hotkeys, hold-to-speak, hyper key |
| Microphone | Privacy & Security → Microphone | Voice dictation (optional) |
| Automation | Privacy & Security → Automation | Selected text capture, AppleScript |
| Calendars | Privacy & Security → Calendars | Schedule view (optional) |
Pro tip: Restart SuperCmd after granting permissions. The
window-adjustandsnippet-expanderSwift binaries explicitly checkAXIsProcessTrusted()— they'll silently fail without this.
Development Build (For Contributors)
# 1. Install Xcode Command Line Tools
xcode-select --install
# 2. Verify Swift compiler
swiftc --version
# 3. Clone and install dependencies
git clone https://github.com/SuperCmdLabs/SuperCmd.git
cd SuperCmd
npm install
# 4. Build native Swift modules (CRITICAL — dev script skips this)
npm run build:native
# 5. Launch development mode
npm run dev
The build:native step compiles all 11 Swift binaries and the fast-paste-addon native module. Skip it, and voice control, window management, and clipboard features simply won't exist.
REAL Code Examples from the Repository
Example 1: Settings Structure (The Configuration Foundation)
SuperCmd persists everything in a clean JSON structure. Here's the actual settings schema with AI configuration:
{
"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"
}
}
What's happening here: This isn't just preferences — it's your entire AI infrastructure configuration. The provider field switches between OpenAI, Anthropic, Gemini, Ollama, or any OpenAI-compatible endpoint. The ollamaBaseUrl default points to localhost for fully local inference. supermemoryApiKey enables persistent AI memory across sessions. Notice speechToTextModel: "native" uses macOS's free neural STT, "whisper" runs OpenAI's model locally, and "parakeet" uses the swift-transformers on-device pipeline. This single JSON file replaces half a dozen separate app configurations.
Example 2: Native Swift Window Tiling (Performance-Critical Code)
The window-adjust binary demonstrates SuperCmd's hybrid architecture. While the UI runs in Electron, window manipulation drops to Swift for direct ApplicationServices framework access:
// window-adjust.swift — compiled to native binary, called via IPC
import ApplicationServices
// Verify accessibility permissions before attempting any window operations
guard AXIsProcessTrusted() else {
print("ERROR: Accessibility permissions not granted")
exit(1)
}
// Get the frontmost application's focused window
let systemWide = AXUIElementCreateSystemWide()
var frontApp: CFTypeRef?
AXUIElementCopyAttributeValue(systemWide, kAXFocusedApplicationAttribute as CFString, &frontApp)
// Apply tiling: halves, thirds, quarters, center, fill, or nudge by 10px
// This runs at native speed, not through JavaScript bridge latency
Why this matters: Electron apps typically use robotjs or similar Node modules for window management — slow, brittle, permission-nightmare prone. SuperCmd's Swift binary talks directly to macOS's accessibility APIs with zero JavaScript overhead. The AXIsProcessTrusted() check explains why window tiling fails without Accessibility permissions: it's a system security requirement, not arbitrary gatekeeping.
Example 3: Extension Execution Engine (The Raycast Compatibility Magic)
This is where SuperCmd's technical ambition becomes clear. The extension-runner.ts bundles and executes Raycast extensions:
// src/main/extension-runner.ts
// Bundles Raycast extensions with esbuild, then requires them through a shim
import { build } from 'esbuild';
import * as path from 'path';
export async function runExtension(extensionPath: string, commandName: string) {
// 1. Bundle the extension with esbuild for Node compatibility
const bundlePath = path.join(extensionPath, '.supercmd', 'bundle.js');
await build({
entryPoints: [path.join(extensionPath, 'src', 'index.tsx')],
bundle: true,
platform: 'node',
target: 'node22',
outfile: bundlePath,
external: ['@raycast/api', '@raycast/utils'], // Provided by our shim
});
// 2. Load through require shim that injects our @raycast/api implementation
const extensionModule = requireWithShim(bundlePath);
// 3. Execute the specific command
await extensionModule.commands[commandName].execute();
}
The engineering here is subtle but massive: Raycast extensions import @raycast/api expecting Raycast's runtime. SuperCmd's shim (src/renderer/src/raycast-api/) implements the entire API surface — List, ActionPanel, useNavigation, showToast, everything — mapping to SuperCmd's React components and Electron IPC. The external config in esbuild prevents bundling the real Raycast API, substituting SuperCmd's implementation at runtime. Extensions run unmodified because they genuinely can't tell the difference.
Example 4: Hold-to-Speak Hotkey Monitor (Voice Workflow Core)
// hotkey-hold-monitor.swift — detects press-and-hold for voice input
import Cocoa
import Carbon
class HotkeyHoldMonitor {
var eventTap: CFMachPort?
var isHolding = false
func startMonitoring(keyCode: Int, modifierFlags: CGEventFlags) {
// Create event tap for key down/up at system level
let eventMask = (1 << CGEventType.keyDown.rawValue) | (1 << CGEventType.keyUp.rawValue)
guard let tap = CGEvent.tapCreate(
tap: .cgSessionEventTap,
place: .headInsertEventTap,
options: .defaultTap,
eventsOfInterest: CGEventMask(eventMask),
callback: { proxy, type, event, refcon in
// Callback logic: detect our specific hotkey, track hold state
// Notify SuperCmd main process when hold begins/ends
return Unmanaged.passRetained(event)
},
userInfo: nil
) else {
print("ERROR: Failed to create event tap — check Input Monitoring permission")
return
}
self.eventTap = tap
let runLoopSource = CFMachPortCreateRunLoopSource(kCFAllocatorDefault, tap, 0)
CFRunLoopAddSource(CFRunLoopGetCurrent(), runLoopSource, .commonModes)
CGEvent.tapEnable(tap: tap, enable: true)
CFRunLoopRun()
}
}
This is why Input Monitoring permission is non-negotiable: The CGEvent.tapCreate call requires kTCCServicePostEvent access — macOS's privacy control for global keylogging prevention. Without it, the tap creation fails and voice workflows simply don't exist. The CFRunLoopRun() keeps the binary alive as a persistent daemon, communicating hold states back to Electron via IPC.
Advanced Usage & Best Practices
Optimize Your AI Spend
SuperCmd's multi-provider setup lets you route by cost and capability:
- Fast queries (summarization, formatting): Ollama local models — $0.00
- Code generation: GPT-4o-mini via OpenAI — ~$0.15/1M tokens
- Complex reasoning: Claude 3.5 Sonnet — ~$3/1M tokens
- Voice narration: Edge TTS — $0.00 (ElevenLabs only for premium voices)
Set defaultModel per workflow type in settings, or switch on-the-fly.
Hyper Key Mastery
Remap Caps Lock to a custom modifier chord (e.g., Cmd+Option+Control+Shift). Suddenly every key becomes a global shortcut without conflicts:
Hyper + T: Launch terminalHyper + C: Copy to specific clipboard slotHyper + V: Paste from clipboard history position 1
The hyper-key-monitor Swift binary handles this at the kernel level — no lag, no missed keystrokes.
Extension Development Tip
Test extensions in both Raycast and SuperCmd simultaneously. The compatibility shim occasionally surfaces Raycast API edge cases that improve your extension's robustness. File issues — the maintainers actively fix shim gaps.
Comparison with Alternatives
| Feature | SuperCmd | Raycast (Free) | Raycast (Pro) | Alfred (Powerpack) |
|---|---|---|---|---|
| Price | Free (OSS) | Free | $10/mo | £34 one-time |
| Raycast Extensions | ✅ Full compatibility | ✅ Native | ✅ Native | ❌ None |
| AI Integration | ✅ Multi-provider, memory | ❌ None | ✅ Limited | ❌ None |
| Voice Dictation | ✅ Whisper/Parakeet/Native | ❌ None | ❌ None | ❌ None |
| Text-to-Speech | ✅ Edge/ElevenLabs | ❌ None | ❌ None | ❌ None |
| Clipboard History | ✅ With quick-paste | ✅ Basic | ✅ Advanced | ✅ Advanced |
| Window Tiling | ✅ 24 commands | ✅ Basic | ✅ Advanced | ❌ None |
| Open Source | ✅ Fully | ❌ No | ❌ No | ❌ No |
| Local-First AI | ✅ Ollama/Parakeet | ❌ No | ❌ No | ❌ No |
| Canvas/Drawing | ✅ Built-in | ❌ No | ❌ No | ❌ No |
| Hyper Key | ✅ Native | ❌ No | ❌ No | ✅ Via workflow |
The verdict: SuperCmd matches or exceeds Raycast Pro's feature set at zero cost, with superior privacy controls and voice capabilities no competitor offers. Alfred's Workflows remain powerful but can't match modern extension ecosystems. For developers already in Raycast's ecosystem, SuperCmd is a drop-in upgrade with immediate savings.
FAQ: What Developers Actually Ask
Is SuperCmd safe? It's not notarized by Apple.
Open source means auditable. Review the code yourself, build from source, or accept the same trade-off thousands of open-source macOS apps require: right-click → Open, or enable in Privacy & Security. No telemetry beyond one anonymous startup event.
Will Raycast extensions break with future Raycast API updates?
The shim follows Raycast's public API. Breaking changes require community updates — but this is true of any compatibility layer. The maintainers actively monitor Raycast's changelog.
Can I use my existing Raycast Pro AI features?
SuperCmd replaces Raycast's AI with direct provider access. You'll need your own API keys, but you gain more models, lower costs, and persistent memory — features Raycast doesn't offer.
Why Electron? Isn't it bloated?
The 11 Swift binaries handle performance-critical paths. Electron provides extension runtime compatibility and rapid UI development. Memory usage is comparable to Raycast's native app — both are modern launchers with rich UIs.
Does voice dictation work offline?
Yes, completely. Select native or parakeet for STT — both run on-device. Whisper downloads the model once, then operates locally. No audio ever leaves your machine.
Can I contribute extensions?
SuperCmd uses standard Raycast extensions from the official store. For SuperCmd-specific features, the project welcomes PRs — see CONTRIBUTING.md.
What happens to my data if the project dies?
Open source means no vendor lock-in. Your settings are local JSON. Your extensions are standard Raycast format. Your AI history is in your provider's account. Fork the repo and maintain it yourself if needed.
Conclusion: The Launcher You Didn't Know You Needed
SuperCmd isn't just another Raycast clone. It's a technical statement — that developer tools can be powerful, beautiful, and genuinely free. The hybrid Electron/Swift architecture solves real problems. The voice workflows eliminate friction you didn't know you had. The AI memory transforms sporadic chatbot use into genuine personal assistance.
But here's what resonates most: in an era of enshittification and subscription creep, SuperCmd proves that open-source communities can out-innovate well-funded startups. The Raycast compatibility isn't a hack — it's a carefully engineered shim that respects the original ecosystem while expanding it dramatically.
My recommendation? If you're paying for Raycast Pro, try SuperCmd for one week. Import your backup, configure your AI provider, test the voice workflows. Measure your actual API costs against that $10/month. For most developers, the math is compelling — and the feature set is superior.
Star the repo. Install the app. Join the Discord. The future of macOS launchers is open source, and it's already here.
Found this breakdown valuable? Give SuperCmd a star on GitHub and share your setup in the comments — I'm particularly curious about creative Hyper Key configurations and local AI workflows.