Skip to main content

​
Welcome to SuperCmd!

This guide will help you go from installation to running your first commands and installing your first extension.
Prerequisites: SuperCmd must be installed with required permissions granted.

​
Launch SuperCmd

There are three ways to open SuperCmd:

Global Hotkey

Press Cmd + Space (default)

Menu Bar

Click the SuperCmd icon in your menu bar

Spotlight

Search for “SuperCmd” in Spotlight
You can change the global hotkey in Settings → General → Global Hotkey.

​
Run Your First Command

Let’s start with something simple.
1

Open the launcher

Press Cmd + Space to open SuperCmd.
2

Search for an app

Type “Safari” (or any app you have installed).SuperCmd will filter results as you type, showing matching applications.
3

Launch it

Press Enter to open the selected app.
Success! You’ve just run your first command. SuperCmd searches applications, System Settings, files, extensions, and more — all from one interface.

​
Explore Built-in Commands

SuperCmd comes with several built-in features. Try these commands:
Type a math expression directly into the search bar:
2 + 2
sqrt(144)
(5 * 8) / 2
SuperCmd will evaluate it and show the result instantly. Press Enter to copy the result to your clipboard.
The smart calculator supports basic arithmetic, square roots, percentages, and more.
Search for “Clipboard History” or press the configured hotkey.You’ll see everything you’ve recently copied:
  • Text
  • Images
  • Files
  • Rich content
Select any item and press Enter to paste it.
Clipboard history is stored locally and never sent to external servers.
Search for “Window Management” to access window tiling presets:
  • Left Half — Tile active window to left half of screen
  • Right Half — Tile active window to right half
  • Maximize — Maximize active window
  • Center — Center window on screen
  • Quarters — Tile to any screen quarter
Select a preset and press Enter to apply it to the frontmost window.
Requires Accessibility permission. See Installation → Permissions.
Create reusable text snippets with keyword triggers.Example:
  1. Search for “Snippets” and select “Create Snippet”
  2. Set a keyword (e.g., ;;email)
  3. Enter the expansion text (e.g., your email address)
  4. Save
Now, type ;;email anywhere and SuperCmd will automatically replace it with your email address.
Great for email signatures, code boilerplate, frequently used phrases, and templates.
Search for “AI Chat” or type ? followed by your question:
? What is the capital of France?
SuperCmd will stream a response from your configured AI provider (OpenAI, Claude, or Ollama).
AI features require API keys. See AI Configuration to set up your provider.
Hold the configured Voice Hotkey (default: Cmd + Shift + Space) to start recording.Speak your query, then release the key. SuperCmd will transcribe your speech to text and execute the command.Wispr Flow-style workflow:
  1. Hold hotkey
  2. Speak
  3. Release
  4. Text appears instantly
Requires Microphone and Input Monitoring permissions.
  1. Select any text in any app
  2. Search for “Read Selection” or use the configured hotkey
  3. SuperCmd will read the text aloud using Edge TTS or ElevenLabs
Controls:
  • Pause/Resume — Space bar
  • Stop — Escape
  • Speed — Adjust in Settings
Perfect for reading long articles, emails, or documentation hands-free.

​
Install Your First Extension

Extensions add powerful features to SuperCmd. Let’s install one!
1

Open the Extension Store

Search for “Store” or “Browse Extensions” in the launcher.Press Enter to open the extension catalog.
2

Browse available extensions

The store shows hundreds of Raycast-compatible extensions:
  • Search engines
  • Developer tools
  • Note-taking apps
  • Social media integrations
  • And much more
Use the search bar to filter by name, description, or author.
3

Install an extension

Let’s install the “GitHub” extension as an example:
  1. Search for “GitHub”
  2. Select the GitHub extension
  3. Press Enter or click Install
  4. Wait for the installation to complete (SuperCmd will clone from GitHub and run npm install)
4

Run the extension

Once installed, search for “GitHub” in the launcher.You’ll see new commands like:
  • Search Repositories
  • My Pull Requests
  • My Issues
  • Trending Repositories
Select a command and press Enter to run it.
5

Configure extension preferences (if needed)

Some extensions require API keys or configuration.If prompted, enter your GitHub personal access token:
  1. Go to GitHub Settings → Tokens
  2. Generate a new token
  3. Copy and paste it into SuperCmd
  4. Press Enter to save
Congratulations! You’ve installed your first extension. You can now use all its commands from the launcher.

​
Extension Management

View Installed

Search for “Extensions” to see all installed extensions and manage them.

Update Extensions

Search for “Update Extensions” to check for and install updates.

Disable Extension

Right-click any extension command and select Disable Extension.

Uninstall

Search for “Extensions”, select one, and choose Uninstall.

​
Keyboard Shortcuts & Navigation

Master these shortcuts to use SuperCmd efficiently:
ShortcutAction
Cmd + SpaceOpen launcher (default)
EscClose launcher
↑ / ↓Navigate results
EnterExecute selected command
Cmd + EnterOpen in new window
Cmd + KOpen action panel
Cmd + ,Open settings
Cmd + BackspaceClear search
TabAutocomplete
Most extensions support Cmd + K to open an action panel with additional options (copy, share, delete, etc.).

​
Customize Your Experience

Make SuperCmd your own:
1

Open Settings

Search for “Settings” or press Cmd + , from the launcher.
2

Explore settings tabs

  • General — Hotkeys, theme, font size, UI style
  • AI — Configure OpenAI, Claude, or Ollama
  • Extensions — Manage installed extensions
  • Advanced — Developer options, storage paths
3

Customize the theme

Choose from:
  • Auto — Follows system dark/light mode
  • Light — Always light theme
  • Dark — Always dark theme
4

Adjust font size

Change the UI font size to your preference (Small, Medium, Large).

​
Configure AI Providers (Optional)

Unlock AI-powered features:
  1. Open Settings → AI
  2. Enable AI features
  3. Select OpenAI as the provider
  4. Enter your OpenAI API key
  5. Choose a model (e.g., gpt-4o-mini)
  6. Save
Get your API key from platform.openai.com

​
Advanced Features

SuperCmd supports Raycast-compatible script commands — shell scripts that appear as launcher commands.How to use:
  1. Place executable scripts in ~/Library/Application Support/SuperCmd/scripts/
  2. Add Raycast metadata at the top: 
    #!/bin/bash

# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title My Script
# @raycast.mode fullOutput
  3. Search for your script name in the launcher
See Raycast Script Commands for examples.
Connect SuperCmd to Supermemory for AI that remembers:
  1. Sign up at supermemory.ai
  2. Get your API key and client ID
  3. Open Settings → AI → Memory
  4. Enter your Supermemory credentials
  5. Enable memory features
Now AI responses will include context from your past conversations and documents.

​
Common Workflows

Developer Workflow

  • Search for repos with GitHub extension
  • Open projects in VS Code
  • Search documentation
  • Copy code snippets

Productivity Workflow

  • Quick math with calculator
  • Expand email templates with snippets
  • Tile windows for multitasking
  • Search notes and documents

Communication Workflow

  • Voice dictation for messages
  • AI-powered writing assistance
  • Clipboard history for copy/paste
  • Text-to-speech for reading emails

Research Workflow

  • Search the web with extensions
  • Read articles aloud with TTS
  • Summarize content with AI
  • Save to memory for later

​
Troubleshooting

  1. Close and reopen the launcher (Esc then Cmd + Space)
  2. Check Settings → Extensions to verify it’s enabled
  3. Try searching for the extension name directly
  1. Verify you’ve configured an AI provider in Settings → AI
  2. Check that your API key is valid
  3. Test the API key directly (e.g., curl to OpenAI)
  4. Check the logs: ~/Library/Logs/SuperCmd/main.log
  1. Grant Microphone permission in System Settings
  2. Test your microphone in another app
  3. Check Settings → AI → Speech to Text Model
  4. Try switching between “native” and “elevenlabs”
  1. Open Settings → General
  2. Change the global hotkey to something unique (e.g., Cmd + Shift + Space)
  3. Disable conflicting shortcuts in other apps (Spotlight, Raycast, Alfred)

​
Next Steps

You’re now ready to use SuperCmd like a pro! Here’s what to explore next:

Explore All Features

Deep dive into extensions, voice input, AI, and more

Configure AI Providers

Set up OpenAI, Claude, or Ollama for AI-powered workflows

Install More Extensions

Browse hundreds of Raycast-compatible extensions

Build from Source

Contribute to SuperCmd or customize it for your needs

Join the Community

Get help, share tips, and connect with other SuperCmd users on Discord

Build docs developers (and LLMs) love

Get started for freeTalk to us