Raycast Terminal & Script Commands 2026: Code direkt aus deinem Launcher ausführen

Die meisten Entwickler leben im Terminal. Git-Commits, Docker-Container, Deploy-Skripte, npm-Befehle — alles ist Muskelgedächtnis. Aber zigmal täglich zwischen Raycast und einem Terminalfenster zu wechseln, sorgt für unnötige Reibung. Raycast Script Commands lassen dich Shell-Befehle, Bash-Skripte, Python-Code und mehr direkt aus dem Raycast-Launcher ausführen — ganz ohne Terminalfenster.

In diesem Leitfaden erfährst du alles darüber, wie du 2026 Terminalbefehle aus Raycast startest: wie Script Commands funktionieren, welche Sprachen unterstützt werden, praktische Beispiele zum Nachbauen und wie du Raycast in deine bestehenden Terminal-Workflows integrierst. Wenn du neu bei Raycast bist, starte zuerst mit unserem Raycast-Setup-Guide und komm dann zurück.

Was sind Raycast Script Commands?

Script Commands sind eigenständige Skriptdateien, die Raycast direkt aus der Command Palette ausführen kann. Denk an maßgeschneiderte Terminalbefehle mit einer UI-Schicht obendrauf. Du schreibst ein Skript in deiner bevorzugten Sprache, fügst einen speziellen Metadaten-Header hinzu, und Raycast verwandelt es in einen durchsuchbaren, startbaren Befehl.

Im Gegensatz zu vollständigen Raycast-Extensions (React und TypeScript) sind Script Commands einfache Dateien — kein Build-Schritt, keine Abhängigkeiten, kein Projektgerüst. Das macht sie ideal für schnelle Automatisierungen und einmalige Aufgaben.

Unterstützte Sprachen

Raycast Script Commands unterstützen jede Sprache, die über eine Shebang-Zeile unter macOS ausgeführt werden kann:

• Bash / Zsh — die häufigste Wahl für Systembefehle und schnelle Automatisierungen
• Python — großartig für Skripte mit HTTP-Requests, JSON-Parsing oder Datenverarbeitung
• Ruby — beliebt für Textmanipulation und Scripting
• Swift — greift nativ auf macOS-System-APIs zu
• AppleScript — steuert macOS-Apps wie Finder, Safari, Mail und Systemeinstellungen
• Node.js — nutze #!/usr/bin/env node für JavaScript-basierte Skripte

Wenn auf deinem Mac ein Interpreter installiert ist und die Sprache eine Shebang-Zeile unterstützt, funktioniert sie mit Raycast. Die meisten Entwickler bleiben bei Bash für Systembefehle und Python für komplexere Aufgaben.

So erstellst du dein erstes Script Command

Schritt 1: Skriptverzeichnis hinzufügen

Öffne Raycast, gehe zu den Einstellungen (oder drücke Cmd + ,), navigiere zu Extensions und klicke auf den +-Button. Wähle „Add Script Directory“ und zeige auf den Ordner, in dem du deine Skripte speichern möchtest. Ich empfehle ~/.raycast-scripts/ oder ein Git-Repo für Versionskontrolle.

Schritt 2: Skriptdatei erstellen

Erstelle eine neue Datei in deinem Skriptverzeichnis. Hier ist ein minimales Bash-Beispiel, das deinen aktuellen Git-Branch anzeigt:

#!/bin/bash

# Required parameters:
# @raycast.schemaVersion 1
# @raycast.title Aktueller Git-Branch
# @raycast.mode inline
# @raycast.packageName Git

# Optional parameters:
# @raycast.icon 🌿
# @raycast.description Zeigt den aktuellen Git-Branch an

cd ~/Projects/my-repo && git branch --show-current

Die Metadatenkommentare oben sagen Raycast, wie der Befehl dargestellt und ausgeführt wird. Die wichtigsten Felder sind:

• @raycast.title — der Name, der in der Raycast Command Palette erscheint
• @raycast.mode — wie die Ausgabe angezeigt wird: inline (in Raycast), compact (kurze Benachrichtigung), fullOutput (scrollbare Ausgabe) oder silent (keine Ausgabe)
• @raycast.packageName — gruppiert verwandte Skripte

Schritt 3: Ausführbar machen

Vergiss nicht, dein Skript ausführbar zu machen:

chmod +x ~/.raycast-scripts/current-git-branch.sh

Raycast erkennt automatisch neue Skripte in deinen konfigurierten Verzeichnissen. Öffne Raycast und tippe den Titel deines Skripts — es taucht sofort auf.

Benutzereingaben mit Argumenten hinzufügen

Script Commands können Argumente annehmen, nach denen Raycast vor der Ausführung fragt. So werden einfache Skripte zu interaktiven Tools:

#!/bin/bash

# @raycast.schemaVersion 1
# @raycast.title Git-Commit
# @raycast.mode compact
# @raycast.packageName Git
# @raycast.argument1 { "type": "text", "placeholder": "Commit-Nachricht" }

cd ~/Projects/my-repo && git add -A && git commit -m "$1"

Wenn du diesen Befehl ausführst, zeigt Raycast ein Textfeld für die Commit-Nachricht. Nachdem du sie eingegeben und Enter gedrückt hast, läuft das Skript mit deiner Eingabe als $1. Du kannst bis zu drei Argumente pro Skript definieren.

Die besten Script-Command-Beispiele für Entwickler

Hier wird es wirklich nützlich. Das sind praxisnahe Beispiele, die du für deinen Workflow adaptieren kannst.

Git-Abkürzungen

Hör auf, für Routine-Git-Operationen ins Terminal zu wechseln:

• Schneller Commit — staged alle Änderungen und committed mit Nachrichten-Argument
• Neueste Änderungen ziehen — git pull --rebase origin main in deinem aktuellen Projekt
• Branch erstellen — nimmt einen Branchnamen, erstellt und checkt den Branch aus
• Status anzeigen — git status --short inline in Raycast
• Stash / Pop — Ein-Tasten-Stash und Wiederherstellung

#!/bin/bash

# @raycast.schemaVersion 1
# @raycast.title Git Pull Rebase
# @raycast.mode compact
# @raycast.packageName Git
# @raycast.icon 🔄

cd ~/Projects/my-repo && git pull --rebase origin main
echo "Auf main gepullt und gerebased"

Docker-Befehle

Verwalte Container, ohne deinen Flow zu verlassen:

• Laufende Container auflisten — docker ps --format "table {{.Names}}\t{{.Status}}" mit fullOutput-Modus
• Alle Container stoppen — docker stop $(docker ps -q)
• Neu aufbauen und neu starten — docker-compose down && docker-compose up -d --build
• Unbenutzte Images aufräumen — docker system prune -af, um Speicherplatz freizugeben

npm- und Paketmanager-Skripte

Starte Projektskripte von überall:

#!/bin/bash

# @raycast.schemaVersion 1
# @raycast.title NPM Dev Server
# @raycast.mode silent
# @raycast.packageName Node.js
# @raycast.icon 📦

cd ~/Projects/my-app && open -a Terminal && osascript -e 'tell app "Terminal" to do script "cd ~/Projects/my-app && npm run dev"'

Dieses Skript öffnet ein Terminalfenster und startet den Dev-Server. Für Skripte, die eine dauerhafte Terminalsitzung brauchen, ist ein neues Fenster oft am besten.

Systempflege

• DNS leeren — sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• Homebrew-Cache säubern — brew cleanup --prune=all
• Speicherauslastung anzeigen — df -h / | tail -1 für eine schnelle Kontrolle
• Prozess nach Name killen — nimmt einen Prozessnamen: pkill -f "$1"
• Papierkorb leeren — rm -rf ~/.Trash/* mit Bestätigungsschritt

Deploy-Skripte

Löse Deployments aus, ohne Terminal oder Browser zu öffnen:

#!/bin/bash

# @raycast.schemaVersion 1
# @raycast.title Deployment in Produktion
# @raycast.mode compact
# @raycast.packageName Deploy
# @raycast.icon 🚀
# @raycast.description Main-Branch pushen und Deploy auslösen

cd ~/Projects/my-app && git push origin main
echo "Auf main gepusht. Deploy gestartet."

Python-Skriptbeispiel

Für alles, was über einfache Shell-Befehle hinausgeht, ist Python eine solide Wahl. Hier ein Skript, das deine öffentliche IP holt:

#!/usr/bin/env python3

# @raycast.schemaVersion 1
# @raycast.title Meine öffentliche IP
# @raycast.mode inline
# @raycast.packageName Netzwerk
# @raycast.icon 🌐

import urllib.request
ip = urllib.request.urlopen('https://api.ipify.org').read().decode()
print(ip)

Die Run Script Extension

Neben Script Commands gibt es im Raycast Store auch Extensions, die Terminalfunktionen in den Launcher holen. Die Terminal-Extension lässt dich Terminalprofile suchen und öffnen. Mehrere Community-Extensions bieten schnellen Zugriff auf Shell-Historie, SSH-Verbindungen und gängige CLI-Tools.

Sieh dir die Liste mit den besten Raycast-Extensions an, um mehr Tools für Terminal-Workflows zu finden. Extensions wie die Brew-Extension lassen dich Homebrew-Pakete komplett in Raycast suchen, installieren und verwalten — kein Terminal nötig.

Raycast mit VS Code und deinem Terminal integrieren

Raycast und dein Terminal müssen keine getrennten Welten sein. So verbindest du beide:

Projekte in VS Code öffnen

Erstelle ein Script Command, das ein bestimmtes Projekt (oder einen Pfad als Argument) in VS Code öffnet:

#!/bin/bash

# @raycast.schemaVersion 1
# @raycast.title In VS Code öffnen
# @raycast.mode silent
# @raycast.packageName Dev
# @raycast.argument1 { "type": "text", "placeholder": "Projektordnername" }

code ~/Projects/$1

Quicklinks für Terminal-Workflows

Raycast Quicklinks können Terminalbefehle sofort öffnen. Erstelle einen Quicklink mit dem terminal://-URL-Schema oder iterm://, wenn du iTerm2 nutzt. Das ist noch schneller als Script Commands für simple, häufige Befehle.

Script Commands mit Raycast AI kombinieren

Wenn du Raycast Pro nutzt, kombinierst du AI Commands mit Script Commands für starke Workflows. Bitte Raycast AI um einen Bash-One-Liner und führe ihn dann mit einem Script Command aus. Oder lass dir von AI Fehlerausgaben eines fehlgeschlagenen Skripts erklären. Es ist eine natürliche Kombination — AI fürs Denken, Script Commands fürs Handeln.

Noch kein Pro? Teste Raycast Pro mit 80 % Rabatt und kostenloser Trial, um AI-Funktionen zusammen mit deinen Skript-Workflows freizuschalten.

Script Commands vs. Extensions: Wann nutzt du was?

Beide können Code ausführen, dienen aber unterschiedlichen Einsatzzwecken:

• Nutze Script Commands, wenn: du eine schnelle Automatisierung brauchst, die Aufgabe ein Einzeiler oder kurzes Skript ist, du kein reichhaltiges UI brauchst oder lieber Bash/Python statt TypeScript nutzt
• Nutze Extensions, wenn: du interaktive Listen, Formulare oder Detailansichten brauchst, das Tool komplexes State-Management erfordert, du im Raycast Store veröffentlichen willst oder Live-Updates und Ladezustände benötigst

In der Praxis verwenden die meisten Entwickler beides. Script Commands übernehmen die schnellen Terminalaufgaben. Extensions kümmern sich um Tools, mit denen du täglich interagierst und ein poliertes Erlebnis willst. Wenn du komplette Extensions bauen möchtest, sieh dir den Raycast API Developer Guide an.

Tipps für bessere Script Commands

fullOutput-Modus für lange Ausgaben nutzen

Wenn dein Skript mehr als ein bis zwei Zeilen zurückgibt, nutze @raycast.mode fullOutput, damit das Ergebnis in Raycast scrollbar ist. Der inline-Modus kürzt lange Ausgaben.

Fehler elegant behandeln

Füge Fehlerprüfungen hinzu, damit Skripte nicht lautlos scheitern. Ein schnelles Bash-Muster:

#!/bin/bash
# ... Raycast-Metadaten ...

if ! command -v docker &> /dev/null; then
  echo "Fehler: Docker ist nicht installiert"
  exit 1
fi

docker ps --format "table {{.Names}}\t{{.Status}}"

Umgebungsvariablen nutzen

Skripte mit API-Schlüsseln oder Tokens sollten diese in Umgebungsvariablen speichern, nicht hardcoden. Raycast erbt deine Shell-Umgebung, also ist alles aus .zshrc oder .bash_profile verfügbar.

Skripte versionieren

Halte dein Script-Commands-Verzeichnis als Git-Repository. So synchronisierst du Skripte über Geräte hinweg, verfolgst Änderungen und teilst sie mit dem Team. Das Raycast-Community-Repo script-commands auf GitHub hat Hunderte inspirierende Beispiele.

Mit Raycast Snippets kombinieren

Für Befehle, die du häufig direkt im Terminal tippst, nutze stattdessen Raycast Snippets. Snippets erweitern Text überall auf deinem Mac — tippe ein Keyword, und es ersetzt sich durch einen längeren Befehl. Nutze Script Commands für die Ausführung, Snippets für Textexpansion.

Raycast optimal für Terminal-Workflows nutzen

Script Commands sind nur ein Puzzleteil. Ein vollständiger Raycast-Terminal-Workflow könnte umfassen:

• Script Commands für Shell-Skripte und Automatisierungen
• Quicklinks zum Springen in Projektordner oder Öffnen von Terminalprofilen
• Snippets für häufig getippte Befehle
• Zwischenablageverlauf für zuvor kopierte Terminalausgaben
• AI Commands (Pro) zum Generieren von Skripten und Debuggen von Fehlern
• Extensions für Brew, GitHub, Docker und andere Entwickler-Tools

Wenn du Raycast noch nicht eingerichtet hast, findest du auf der Raycast-Pro-Rabattseite den aktuell besten Deal. Und unser Guide „Was ist Raycast?“ erklärt die Grundlagen, bevor du in Power-Features wie Script Commands einsteigst.

Häufig gestellte Fragen

Welche Sprachen kann ich für Raycast Script Commands verwenden?

Raycast unterstützt Bash, Python, Ruby, Swift und AppleScript direkt. Jede Sprache mit gültiger Shebang-Zeile, die auf macOS läuft — inklusive Node.js, PHP, Perl und anderer — funktioniert. Bash und Python sind mit Abstand am beliebtesten. Stell nur sicher, dass der Interpreter installiert ist und die Skriptdatei ausführbar ist.

Was ist der Unterschied zwischen Script Commands und Raycast Extensions?

Script Commands sind eigenständige Skriptdateien (Bash, Python usw.), die direkt aus Raycast laufen, ohne Build-Schritt oder Abhängigkeiten. Sie sind perfekt für schnelle Terminalautomatisierungen. Extensions sind vollständige React/TypeScript-Apps mit reichhaltigen UI-Komponenten — Listen, Formulare, Detailansichten, Aktionspanels. Nutze Script Commands für einfache Aufgaben mit Textausgabe. Nutze Extensions, wenn du ein interaktives Interface brauchst.

Können Raycast Script Commands Benutzereingaben annehmen?

Ja. Du kannst bis zu drei Argumente im Metadata-Header mit @raycast.argument1, @raycast.argument2 und @raycast.argument3 definieren. Jedes Argument hat einen Typ und Platzhaltertext. Beim Ausführen zeigt Raycast Eingabefelder für jedes Argument. Die Werte werden als Positionsparameter ($1, $2, $3 in Bash) oder Umgebungsvariablen übergeben.

Brauche ich Raycast Pro, um Script Commands zu nutzen?

Nein. Script Commands stehen im kostenlosen Raycast-Plan ohne Einschränkungen zur Verfügung. Du kannst unbegrenzt Script Commands erstellen, importieren und ausführen. Dennoch ergänzt Raycast Pro mit Funktionen wie AI Commands und Cloud Sync deine skriptbasierten Workflows hervorragend — insbesondere AI zum Generieren und Debuggen von Skripten. Sichere dir hier das aktuelle Pro-Angebot.

Wie teile ich Script Commands mit meinem Team?

Script Commands sind einfache Dateien, daher ist Teilen unkompliziert. Am besten hältst du deine Skripte in einem gemeinsamen Git-Repository, das Teammitglieder klonen und in Raycast einbinden. Die Raycast-Community pflegt außerdem das Open-Source-Repository script-commands auf GitHub mit Hunderten Community-Skripten. Um ein Skript zu importieren, leg es einfach in ein Verzeichnis, das in Raycast als Script-Commands-Ordner konfiguriert ist.