Comment créer des commandes personnalisées et des préréglages dans Raycast AI pour fluidifier vos flux de travail sur macOS

Passer constamment de son éditeur de code au terminal et aux onglets de navigateur pour interagir avec des assistants IA brise la concentration des développeurs. Raycast AI élimine cette friction en intégrant les grands modèles de langage directement au cœur de macOS sous la forme d'un lanceur système. Au lieu de copier du texte, d'ouvrir un navigateur, de saisir une consigne et de coller la réponse, vous pouvez déclencher des opérations d'IA sur mesure dans n'importe quelle application à l'aide d'un simple raccourci clavier.

L'écosystème Raycast AI repose sur deux briques complémentaires :

1. Les commandes d'IA personnalisées (Custom AI Commands) : des actions rapides basées sur des prompts, qui s'exécutent sur le texte sélectionné ou le presse-papiers, avec un affichage dans une fenêtre volante ou un remplacement direct in situ.
2. Les préréglages et agents d'IA (AI Presets / Agents) : des modèles de système et des personas permanents conçus pour des conversations suivies dans le chat, intégrant le choix du modèle, l'effort de raisonnement et l'accès à des outils ciblés.

Ce guide détaille la création de commandes d'IA personnalisées, la configuration d'agents et de presets de chat, l'utilisation des variables dynamiques et l'attribution de raccourcis globaux pour décupler votre productivité quotidienne.

1. Créer des commandes d'IA personnalisées

Les commandes d'IA personnalisées sont parfaites pour les tâches répétitives bien délimitées, comme le refactor de code, l'inférence de types, la correction syntaxique ou l'explication de requêtes SQL.

Étapes de configuration

1. Appuyez sur ⌥ Espace (ou votre raccourci Raycast) pour faire apparaître le lanceur.
2. Saisissez Create AI Command et validez avec Entrée. (Vous pouvez aussi faire ⌘D sur une commande existante dans Search AI Commands pour la dupliquer).
3. Remplissez le formulaire de configuration :
   • Name & Icon (Nom et icône) : Donnez un nom explicite (par exemple Refactor to TypeScript ou Explain SQL Query) et choisissez une icône.
   • Prompt (Consigne) : Rédigez l'instruction destinée au modèle. Tapez { pour faire appel aux variables dynamiques et @ pour intégrer des extensions d'outils.
   • Model (Modèle) : Définissez le modèle cible (Claude 3.5 Sonnet, GPT-4o ou des modèles de raisonnement comme o1/o3-mini). Laissez vide pour utiliser le modèle par défaut configuré dans Settings → AI → Models & Providers.
   • Creativity (Créativité / Température) : Réglez le niveau entre None, Low, Medium, High ou Maximum. Pour les tâches rigoureuses comme le code ou la génération JSON, privilégiez None ou Low.
   • Reasoning Effort (Effort de raisonnement) : Ajustez le budget de réflexion si le modèle sélectionné prend en charge le raisonnement approfondi.
   • Output Behavior (Comportement de sortie) :
     • Open in Raycast : Affiche le résultat dans une fenêtre volante dédiée, avec possibilité d'appuyer sur ⌘J pour basculer la conversation complète dans AI Chat.
     • Replace Selection : Écrase directement la sélection active dans l'application au premier plan par la réponse générée.
   • Highlight Editing Changes (Surligner les modifications) : En mode Replace Selection, met en évidence les lignes modifiées pour une vérification visuelle immédiate.
4. Enregistrez avec ⌘ Entrée. La commande est immédiatement disponible dans la recherche racine.

2. Exploiter les variables dynamiques (Dynamic Placeholders)

Les variables dynamiques permettent d'injecter automatiquement le contexte de votre espace de travail dans les consignes, sans copier-coller manuel.

Modificateurs de chaîne

Vous pouvez associer des modificateurs avec une barre verticale pour formater le texte d'entrée :

• {clipboard | trim} : Supprime les espaces et retours à la ligne superflus au début et à la fin.
• {selection | lowercase} ou {selection | uppercase} : Harmonise la casse.
• {selection | json-stringify} : Échappe les guillemets et caractères spéciaux pour une insertion sécurisée dans un JSON.
• {clipboard | raw} : Empêche l'encadrement automatique du texte par des guillemets.

Exemples pratiques de commandes

Exemple 1 : Génération in situ de types TypeScript et documentation JSDoc

• Comportement de sortie : 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.

Exemple 2 : Générateur interactif de messages de commit Git

• Comportement de sortie : 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. Configurer des préréglages (Presets) et des agents d'IA personnalisés

Si les commandes d'IA conviennent aux actions ponctuelles, les projets d'ingénierie plus complexes nécessitent des sessions de chat continues, guidées par des directives d'architecture fermes et un accès encadré aux outils.

Appelée AI Chat Presets dans Raycast v1, cette fonctionnalité a évolué pour devenir les Agents dans Raycast v2, tout en conservant une compatibilité totale avec les configurations existantes et l'annuaire communautaire Preset Explorer.

Créer un agent sur mesure

1. Rendez-vous dans Settings → AI → Agents (ou lancez Search Agents puis Create Agent).
2. Configurez les propriétés de l'agent :
   • Name & Icon : Un titre descriptif (ex. Optimiseur de Requêtes PostgreSQL ou Revue de Code Senior).
   • Model : Attribuez un LLM précis ou choisissez Inherit pour suivre le modèle actif de la fenêtre de chat.
   • Instructions (Prompt système) : Précisez les exigences architecturales, les conventions de code et les règles de réponse.
   • AI Extensions (Outils autorisés) : Sélectionnez les extensions que l'agent a le droit de solliciter (par ex. @calendar, @github, @file-search).
3. Sauvegardez avec ⌘ Entrée.

Invoquer et changer d'agent

• Dans AI Chat : Tapez / dans le champ de saisie pour ouvrir le sélecteur rapide, ou faites ⌘K → Change Agent.
• Depuis le lanceur principal : Tapez directement le nom de l'agent dans la barre de recherche Raycast et validez pour démarrer une nouvelle session configurée avec ce persona.
• Import communautaire : Découvrez sur presets.ray.so des modèles partagés par d'autres utilisateurs et importez-les en un clic.

4. Raccourcis globaux et correction instantanée avec Quick Fix

Pour éliminer toute friction, associez directement vos commandes et agents à des raccourcis clavier globaux :

1. Assigner des Hotkeys dédiés :

   • Ouvrez Settings → Extensions → AI (ou faites ⌘K → Configure Command sur l'élément de votre choix).
   • Cliquez sur la case Hotkey et enregistrez votre combinaison (ex. ⌃⌥C pour le générateur de commits ou ⌃⌥R pour le refactor de code).
   • Dès lors, surlignez du code dans VS Code ou Xcode et pressez ⌃⌥R : le remplacement s'effectue immédiatement sans ouvrir le lanceur Raycast.

2. Exploiter Quick Fix :

   • Raycast intègre nativement Quick Fix, spécialement calibré pour corriger la grammaire et l'orthographe.
   • Par défaut, une double pression sur la touche Shift droite (Double Right Shift) analyse et corrige le texte dans le champ actif.
   • Dans Settings → AI → Quick Fix, activez Preserve Formatting pour conserver les listes, le gras et les liens hypertexte lors de la correction dans Notion ou Slack.

5. Permissions système, tarification et gestion des modèles

Autorisations d'accessibilité sur macOS

Le remplacement automatique in situ (Replace Selection) et Quick Fix s'appuient sur l'API d'accessibilité de macOS :

• Rendez-vous dans Réglages Système → Confidentialité et sécurité → Accessibilité (ou « Contrôle des appareils et accès aux données » selon la version d'OS).
• Vérifiez que l'accès est bien accordé à Raycast.

Modèle économique et option BYOK (Bring Your Own Key)

• Raycast Free : Donne accès aux fonctionnalités de base du lanceur (calculatrice, snippets, historique du presse-papiers, catalogue d'extensions).
• Raycast Pro (10 $/mois ou 96 $/an) : Débloque Raycast AI avec un quota mensuel de crédits d'IA, la synchronisation dans le cloud et les commandes d'IA personnalisées.
• Formules Pro+ et Max : Fournissent des volumes accrus de crédits pour les utilisateurs intensifs sollicitant des modèles avancés.
• BYOK et liaisons d'abonnements : Les abonnés payants peuvent enregistrer leurs propres clés d'API OpenAI, Anthropic, Google et OpenRouter, ou connecter directement leurs abonnements ChatGPT et Claude pour piloter leurs coûts tout en profitant de l'ergonomie native de Raycast.

En combinant la vélocité des commandes personnalisées à exécution unique et la rigueur contextuelle des préréglages de chat, les utilisateurs de macOS s'affranchissent des allers-retours dans le navigateur et font de l'IA une extension naturelle de leur clavier.

Références

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