Benutzerdefinierte AI-Befehle und Presets in Raycast AI erstellen: Desktop-Workflows unter macOS optimieren

Das ständige Wechseln zwischen Code-Editor, Terminal und Browser-Tabs zur Nutzung webbasierter KI-Assistenten unterbricht den Programmierfokus empfindlich. Raycast AI beseitigt diese Reibungsverluste, indem es moderne Sprachmodelle als System-Launcher direkt in macOS integriert. Statt Codeblöcke zu kopieren, ein Browserfenster zu öffnen, Prompts einzugeben und Ergebnisse manuell zurückzutragen, lassen sich maßgeschneiderte KI-Aufgaben in jeder beliebigen Anwendung über Tastaturkürzel ausführen.

Raycast AI stellt zwei zentrale, sich ergänzende Werkzeuge bereit:

1. Benutzerdefinierte AI-Befehle (Custom AI Commands): Einmalige, promptbasierte Aktionen, die direkt auf markiertem Text oder der Zwischenablage operieren. Die Ergebnisse werden in einem schwebenden Fenster dargestellt oder ersetzen die Textauswahl unmittelbar an Ort und Stelle.
2. AI-Presets und Agenten (AI Presets / Agents): Dauerhafte System-Prompt-Vorlagen und Rollenprofile für mehrstufige Chat-Sitzungen – inklusive spezifischer Modellauswahl, Denkleistung und zugewiesener Werkzeugerweiterungen.

Diese Anleitung erläutert die Konfiguration benutzerdefinierter AI-Befehle, die Erstellung spezialisierter Chat-Agenten, den Einsatz dynamischer Platzhalter sowie die Belegung globaler Tastenkürzel für einen nahtlosen Desktop-Workflow.

1. Benutzerdefinierte AI-Befehle erstellen

Benutzerdefinierte AI-Befehle eignen sich hervorragend für abgegrenzte Routineaufgaben wie Code-Refactoring, Typinferenz, Textkorrekturen oder das Erklären komplexer SQL-Abfragen.

Schritt-für-Schritt-Einrichtung

1. Drücken Sie ⌥ Leertaste (oder Ihr konfiguriertes Raycast-Kürzel), um den Launcher zu öffnen.
2. Suchen Sie nach Create AI Command und bestätigen Sie mit Enter. (Alternativ öffnen Sie Search AI Commands, wählen einen Standardbefehl und drücken ⌘D, um ihn zu duplizieren und anzupassen).
3. Füllen Sie das Formular aus:
   • Name & Icon: Wählen Sie eine prägnante Bezeichnung (z. B. Refactor to TypeScript oder Explain SQL Query) und ein passendes Symbol.
   • Prompt: Formulieren Sie die Anweisung an das Modell. Über { fügen Sie dynamische Platzhalter ein, über @ binden Sie Werkzeuge ein.
   • Model: Bestimmen Sie das Zielmodell (z. B. Claude 3.5 Sonnet, GPT-4o oder Denkmodelle wie o1/o3-mini). Bleibt das Feld leer, greift der Standard aus Settings → AI → Models & Providers.
   • Creativity (Temperatur): Wählen Sie zwischen None, Low, Medium, High oder Maximum. Für deterministische Aufgaben wie Refactoring oder JSON-Generierung empfiehlt sich None oder Low.
   • Reasoning Effort: Passen Sie bei unterstützten Reasoning-Modellen die Denkdauer an.
   • Output Behavior (Ausgabeverhalten):
     • Open in Raycast: Öffnet das Ergebnis in einem Raycast-Fenster, wo es kopiert oder über ⌘J direkt in einen vollständigen AI-Chat überführt werden kann.
     • Replace Selection: Überschreibt den aktuell markierten Text im aktiven Fenster direkt mit der generierten KI-Antwort.
   • Highlight Editing Changes: Hebt vorgenommene Änderungen optisch hervor, wenn Replace Selection aktiviert ist.
4. Drücken Sie ⌘ Enter, um den Befehl zu speichern. Er steht ab sofort in der Hauptsuche zur Verfügung.

2. Dynamische Platzhalter (Dynamic Placeholders) nutzen

Dynamische Platzhalter erfassen den aktuellen Kontext Ihrer Desktop-Umgebung zur Laufzeit, ohne dass Sie Inhalte manuell kopieren und einfügen müssen.

Modifikatoren zur Texttransformation

Platzhalter lassen sich über Pipes mit Modifikatoren formatieren:

• {clipboard | trim}: Entfernt führende und nachgestellte Leerzeichen sowie Zeilenumbrüche.
• {selection | lowercase} oder {selection | uppercase}: Vereinheitlicht Groß- und Kleinschreibung.
• {selection | json-stringify}: Maskiert Sonderzeichen zur sicheren Einbettung in JSON-Objekte.
• {clipboard | raw}: Verhindert die standardmäßige Umhüllung mit Anführungszeichen.

Praxiserprobte Befehlsbeispiele

Beispiel 1: TypeScript-Typen & JSDoc direkt an Ort und Stelle generieren

• Output Behavior: Replace Selection
• Creativity: Low
• Prompt:

Analyze the following code selection:
{selection}

Add strict TypeScript types, explicit interface definitions, and JSDoc documentation. Return only the updated code block without surrounding explanations or markdown wrappers.

Beispiel 2: Interaktiver Generator für Git-Commit-Nachrichten

• Output Behavior: Open in Raycast
• Prompt:

Write a concise, conventional git commit message based on the following diff or staged summary:
{clipboard}

Focus on type: {argument name="Commit Type" default="feat"}.
Format as:
<type>(<scope>): <summary>

- Optional body explaining the why behind the change.

3. AI-Presets und benutzerdefinierte Agenten konfigurieren

Während AI-Befehle auf unmittelbare Einzelschritte ausgelegt sind, erfordern anspruchsvolle Entwicklungsaufgaben oft fortlaufende Dialoge mit festgelegten Architekturvorgaben und Werkzeugzugriffen.

In Raycast v1 firmierte diese Funktionalität unter dem Namen AI Chat Presets; in Raycast v2 wurde sie zu Agents (Agenten) weiterentwickelt und bleibt vollständig kompatibel mit bestehenden Profilen sowie dem Preset Explorer.

Eigenen Agenten anlegen

1. Navigieren Sie zu Settings → AI → Agents (oder führen Sie Search Agents aus und wählen Create Agent).
2. Konfigurieren Sie die Eigenschaften:
   • Name & Icon: Zuweisung einer aussagekräftigen Identität (z. B. PostgreSQL Query Optimizer oder Senior Code Reviewer).
   • Model: Modell festlegen oder Inherit wählen, um der Auswahl des Chatfensters zu folgen.
   • Instructions (System-Prompt): Rollenprofil, architektonische Leitlinien, Code-Konventionen und Einschränkungen hinterlegen.
   • AI Extensions: Festlegen, welche Werkzeuge der Agent ansprechen darf (z. B. @calendar, @github, @file-search).
3. Mit ⌘ Enter speichern.

Agenten aufrufen und wechseln

• Im AI Chat: Tippen Sie / in das Eingabefeld für das Schnellmenü oder drücken Sie ⌘K → Change Agent.
• Aus der Hauptsuche: Geben Sie den Namen des Agenten direkt im Raycast-Suchfenster ein und drücken Sie Enter, um einen Chat mit dessen Profil zu öffnen.
• Community-Vorlagen: Über presets.ray.so lassen sich erprobte Profile mit einem Klick lokal einbinden.

4. Globale Hotkeys und Quick Fix für verzögerungsfreies Arbeiten

Um Arbeitsunterbrechungen auf null zu reduzieren, lassen sich Befehle und Agenten direkt mit macOS-weiten Shortcuts ansteuern:

1. Eigene Hotkeys zuweisen:

   • Öffnen Sie Settings → Extensions → AI (oder drücken Sie ⌘K → Configure Command auf dem jeweiligen Eintrag).
   • Klicken Sie in das Feld Hotkey und erfassen Sie eine Tastenkombination (z. B. ⌃⌥C für Commit-Nachrichten oder ⌃⌥R für Code-Refactoring).
   • Wird nun in VS Code oder Xcode Text markiert und ⌃⌥R gedrückt, erfolgt die Ersetzung unmittelbar, ohne dass Raycast geöffnet werden muss.

2. Quick Fix nutzen:

   • Raycast enthält die integrierte Funktion Quick Fix, die auf die schnelle Rechtschreib- und Grammatikprüfung fokussiert ist.
   • Ein doppelter Druck auf die rechte Shift-Taste (Double Right Shift) analysiert und korrigiert den Text im aktiven Eingabefeld.
   • Unter Settings → AI → Quick Fix empfiehlt sich die Aktivierung von Preserve Formatting, um Fettschrift und Links in Rich-Text-Editoren wie Notion oder Slack beizubehalten.

5. Berechtigungen, Preismodelle und Modellanbindung

Bedienungshilfen-Berechtigungen (Accessibility)

Für die direkte Textübernahme (Replace Selection) und Quick Fix benötigt Raycast Zugriffsrechte unter macOS:

• Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen (in aktuellen macOS-Versionen „Gerätesteuerung und Datenzugriff“).
• Aktivieren Sie dort die Freigabe für Raycast.

Tarife und Bring-Your-Own-Key (BYOK)

• Raycast Free: Beinhaltet den grundlegenden Launcher (Rechner, Snippets, Zwischenablage-Verlauf, Extension Store).
• Raycast Pro (10 $/Monat oder 96 $/Jahr): Schaltet Raycast AI inklusive monatlicher AI-Credits, Cloud Sync und benutzerdefinierter Befehle frei.
• Pro+ und Max Tarife: Bieten höhere Credit-Volumina für den intensiven Einsatz von Spitzenmodellen.
• BYOK und Abonnements: Abonnenten der Pro-Stufe können eigene API-Schlüssel von OpenAI, Anthropic, Google und OpenRouter hinterlegen oder bestehende ChatGPT- bzw. Claude-Abonnements direkt verknüpfen, um Inferenzkosten flexibel zu verwalten.

Durch das Zusammenspiel von blitzschnellen Ein-Klick-Befehlen und kontextstarken Chat-Presets integrieren macOS-Nutzer künstliche Intelligenz direkt in ihre tägliche Arbeitsumgebung, ohne ständig den Fokus zu verlieren.

Referenzen

• AI Commands | Raycast Manual
• Dynamic Placeholders | Raycast Manual
• Agents | Raycast Manual
• AI Chat | Raycast Manual