Raycast Terminal & Script Commands 2026 : exécutez du code depuis votre lanceur

La plupart des développeurs vivent dans le terminal. Commits Git, conteneurs Docker, scripts de déploiement, commandes npm — tout est muscle memory. Mais passer de Raycast à une fenêtre terminal des dizaines de fois par jour ajoute une friction inutile. Raycast Script Commands vous permettent d'exécuter des commandes shell, des scripts bash, du code Python et plus encore directement depuis le lanceur Raycast — sans fenêtre terminal.

Dans ce guide, je couvre tout ce qui concerne l'exécution de commandes terminal depuis Raycast en 2026 : comment fonctionnent les Script Commands, quelles langues sont prises en charge, des exemples pratiques à reprendre, et comment intégrer Raycast à vos workflows terminal existants. Si vous débutez avec Raycast, commencez par notre guide de configuration Raycast puis revenez ici.

Que sont les Raycast Script Commands ?

Les Script Commands sont des fichiers script autonomes que Raycast peut exécuter directement depuis la palette de commandes. Considérez-les comme des commandes terminal personnalisées avec une couche UI supplémentaire. Vous écrivez un script dans votre langue préférée, ajoutez un en-tête de métadonnées spécial, et Raycast le transforme en commande recherchable et lançable.

Contrairement aux extensions Raycast complètes (qui utilisent React et TypeScript), les Script Commands sont de simples fichiers — pas d'étape de build, pas de dépendances, pas d'échafaudage de projet. Ils sont donc parfaits pour les automatisations rapides et les tâches ponctuelles.

Langues prises en charge

Raycast Script Commands prend en charge toute langue pouvant s'exécuter via une ligne shebang sur macOS :

• Bash / Zsh — le choix le plus courant pour les commandes système et les automatisations rapides
• Python — idéal pour les scripts qui nécessitent des requêtes HTTP, du parsing JSON ou du traitement de données
• Ruby — populaire pour la manipulation de texte et le scripting
• Swift — accès natif aux API système macOS
• AppleScript — contrôle des apps macOS comme Finder, Safari, Mail et Réglages Système
• Node.js — utilisez #!/usr/bin/env node pour des scripts basés sur JavaScript

Si une langue dispose d'un interpréteur installé sur votre Mac et supporte une ligne shebang, elle fonctionne avec Raycast. La plupart des développeurs restent sur Bash pour les commandes système et Python pour tout ce qui est plus complexe.

Comment créer votre premier Script Command

Étape 1 : ajouter un répertoire de scripts

Ouvrez Raycast, allez dans Settings (ou appuyez sur Cmd + ,), naviguez vers Extensions et cliquez sur le bouton +. Sélectionnez « Add Script Directory » et pointez vers le dossier où vous stockerez vos scripts. Je recommande ~/.raycast-scripts/ ou de les garder dans un dépôt Git pour le versioning.

Étape 2 : créer un fichier script

Créez un nouveau fichier dans votre répertoire de scripts. Voici un exemple Bash minimal qui affiche votre branche Git actuelle :

#!/bin/bash

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

# Optional parameters:
# @raycast.icon 🌿
# @raycast.description Show the current Git branch

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

Les commentaires de métadonnées en haut indiquent à Raycast comment afficher et exécuter la commande. Les champs clés sont :

• @raycast.title — le nom affiché dans la palette de commandes Raycast
• @raycast.mode — la façon dont la sortie est affichée : inline (affichée dans Raycast), compact (notification brève), fullOutput (sortie défilable) ou silent (pas de sortie)
• @raycast.packageName — regroupe les scripts liés

Étape 3 : le rendre exécutable

N'oubliez pas de rendre votre script exécutable :

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

Raycast détecte automatiquement les nouveaux scripts dans vos répertoires configurés. Ouvrez Raycast et tapez le titre de votre script — il devrait apparaître immédiatement.

Ajouter des entrées utilisateur avec des arguments

Les Script Commands peuvent accepter des arguments que Raycast demande avant l'exécution. Cela transforme de simples scripts en outils interactifs :

#!/bin/bash

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

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

Quand vous exécutez cette commande, Raycast affiche un champ texte pour le message de commit. Après avoir saisi votre message et pressé Entrée, le script s'exécute avec votre saisie comme $1. Vous pouvez définir jusqu'à trois arguments par script.

Meilleurs exemples de Script Commands pour développeurs

C'est là que les Script Commands deviennent vraiment utiles. Voici des exemples pratiques à adapter à votre workflow.

Raccourcis Git

Arrêtez d'ouvrir le terminal pour les opérations Git routinières :

• Commit rapide — stage tous les changements et commit avec un message passé en argument
• Pull des dernières modifications — git pull --rebase origin main dans votre projet actuel
• Créer une branche — prend un nom de branche en argument, crée et passe sur la branche
• Afficher le status — git status --short affiché inline dans Raycast
• Stash / pop — stash et restauration en une touche

#!/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 "Pulled and rebased on main"

Commandes Docker

Gérez vos conteneurs sans quitter votre flow :

• Lister les conteneurs actifs — docker ps --format "table {{.Names}}\t{{.Status}}" avec le mode fullOutput
• Arrêter tous les conteneurs — docker stop $(docker ps -q)
• Reconstruire et redémarrer — docker-compose down && docker-compose up -d --build
• Nettoyer les images inutilisées — docker system prune -af pour libérer de l'espace disque

Scripts npm et gestionnaires de packages

Exécutez vos scripts projet depuis n'importe où :

#!/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"'

Celui-ci ouvre une fenêtre Terminal et lance le serveur de développement. Pour les scripts qui nécessitent une session terminal persistante, ouvrir une nouvelle fenêtre est souvent la meilleure approche.

Maintenance système

• Vider le DNS — sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• Nettoyer le cache Homebrew — brew cleanup --prune=all
• Afficher l'utilisation disque — df -h / | tail -1 pour un check rapide
• Tuer un processus par nom — prend un argument nom de processus : pkill -f "$1"
• Vider la corbeille — rm -rf ~/.Trash/* avec étape de confirmation

Scripts de déploiement

Déclenchez vos déploiements sans ouvrir un terminal ou un navigateur :

#!/bin/bash

# @raycast.schemaVersion 1
# @raycast.title Deploy to Production
# @raycast.mode compact
# @raycast.packageName Deploy
# @raycast.icon 🚀
# @raycast.description Push main branch and trigger deploy

cd ~/Projects/my-app && git push origin main
echo "Pushed to main. Deploy triggered."

Exemple de script Python

Pour tout ce qui dépasse les commandes shell de base, Python est un excellent choix. Voici un script qui récupère votre IP publique :

#!/usr/bin/env python3

# @raycast.schemaVersion 1
# @raycast.title My Public IP
# @raycast.mode inline
# @raycast.packageName Network
# @raycast.icon 🌐

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

L'extension Run Script

Au-delà des Script Commands, Raycast possède aussi des extensions dans le Store qui amènent des fonctionnalités terminal dans le lanceur. L'extension Terminal vous permet de rechercher et d'ouvrir des profils terminal directement. Plusieurs extensions communautaires offrent un accès rapide à l'historique shell, aux connexions SSH et aux outils CLI courants.

Parcourez la liste des meilleures extensions Raycast pour trouver des outils qui complètent les workflows terminal. Des extensions comme Brew vous permettent de rechercher, installer et gérer des packages Homebrew entièrement dans Raycast — sans terminal.

Intégrer Raycast avec VS Code et votre terminal

Raycast et votre terminal n'ont pas besoin d'être deux mondes séparés. Voici comment les connecter :

Ouvrir des projets dans VS Code

Créez un Script Command qui ouvre un projet spécifique (ou prend un chemin en argument) dans VS Code :

#!/bin/bash

# @raycast.schemaVersion 1
# @raycast.title Open in VS Code
# @raycast.mode silent
# @raycast.packageName Dev
# @raycast.argument1 { "type": "text", "placeholder": "Project folder name" }

code ~/Projects/$1

Quicklinks pour les workflows terminal

Les Quicklinks Raycast peuvent ouvrir des commandes terminal instantanément. Créez un Quicklink avec un schéma URL terminal:// ou iterm:// si vous utilisez iTerm2. C'est encore plus rapide que les Script Commands pour les commandes simples utilisées fréquemment.

Combiner Script Commands avec Raycast AI

Si vous êtes sur Raycast Pro, vous pouvez utiliser AI Commands en parallèle des Script Commands pour des workflows puissants. Demandez à Raycast AI de générer un one-liner bash, puis exécutez-le via un Script Command. Ou utilisez l'IA pour expliquer la sortie d'erreur d'un script échoué. C'est un duo naturel — l'IA pour réfléchir, les Script Commands pour agir.

Pas encore sur Pro ? Essayez Raycast Pro avec 80 % de réduction et un essai gratuit pour débloquer les fonctionnalités IA aux côtés de vos workflows scriptés.

Script Commands vs. extensions : quand utiliser quoi

Les Script Commands et les extensions complètes peuvent toutes deux exécuter du code, mais elles servent des objectifs différents :

• Utilisez les Script Commands quand : vous avez besoin d'une automatisation rapide, la tâche tient en une ligne ou un petit script, vous n'avez pas besoin d'UI riche, ou vous préférez Bash/Python à TypeScript
• Utilisez les extensions quand : vous avez besoin de listes, formulaires ou vues détaillées interactives, l'outil nécessite une gestion d'état complexe, vous voulez publier dans le Raycast Store, ou vous avez besoin de mises à jour en temps réel et d'états de chargement

En pratique, la plupart des développeurs utilisent les deux. Les Script Commands gèrent les tâches terminal rapides et « dirty ». Les extensions couvrent les outils que vous utilisez quotidiennement et pour lesquels vous voulez une expérience soignée. Si construire des extensions complètes vous intéresse, consultez le guide développeur Raycast API.

Conseils pour écrire de meilleurs Script Commands

Utiliser le mode fullOutput pour les sorties longues

Si votre script renvoie plus de deux lignes, utilisez @raycast.mode fullOutput afin que le résultat soit défilable dans Raycast. Le mode inline tronque les longues sorties.

Gérer les erreurs avec soin

Ajoutez des contrôles d'erreur pour éviter des échecs silencieux. Un motif rapide en Bash :

#!/bin/bash
# ... raycast metadata ...

if ! command -v docker &> /dev/null; then
  echo "Error: Docker is not installed"
  exit 1
fi

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

Utiliser des variables d'environnement

Pour les scripts nécessitant des clés API ou des tokens, stockez-les dans des variables d'environnement plutôt que de les hardcoder. Raycast hérite de votre environnement shell, donc tout ce qui se trouve dans votre .zshrc ou .bash_profile est accessible.

Versionner vos scripts

Gardez votre répertoire Script Commands comme dépôt Git. Cela vous permet de synchroniser les scripts entre machines, suivre les changements et partager avec l'équipe. Le dépôt communautaire script-commands sur GitHub regorge d'exemples à consulter pour l'inspiration.

Combiner avec Raycast Snippets

Pour les commandes que vous tapez souvent dans le terminal, envisagez d'utiliser Raycast Snippets. Les snippets étendent du texte partout sur votre Mac — tapez un mot-clé et il est remplacé par une commande plus longue. Utilisez les Script Commands pour l'exécution, les Snippets pour l'expansion de texte.

Tirer le meilleur de Raycast pour les workflows terminal

Les Script Commands ne sont qu'une pièce du puzzle. Un workflow terminal Raycast complet peut inclure :

• Script Commands pour exécuter scripts shell et automatisations
• Quicklinks pour sauter vers des répertoires projet ou ouvrir des profils terminal
• Snippets pour étendre des commandes tapées fréquemment
• Clipboard History pour récupérer des sorties terminal copiées
• AI Commands (Pro) pour générer des scripts et déboguer les erreurs
• Extensions pour Brew, GitHub, Docker et autres outils développeurs

Si vous n'avez pas encore configuré Raycast, la page de remise Raycast Pro propose la meilleure offre actuelle. Et notre guide sur ce qu'est Raycast couvre les fondamentaux avant de plonger dans des fonctionnalités avancées comme Script Commands.

Foire aux questions

Quelles langues puis-je utiliser pour Raycast Script Commands ?

Raycast prend en charge Bash, Python, Ruby, Swift et AppleScript nativement. Toute langue avec une ligne shebang valide qui s'exécute sur macOS fonctionnera — y compris Node.js, PHP, Perl et d'autres. Bash et Python sont de loin les choix les plus populaires. Assurez-vous simplement que l'interpréteur est installé sur votre système et que le fichier script est exécutable.

Quelle est la différence entre Script Commands et Raycast Extensions ?

Les Script Commands sont des fichiers script autonomes (Bash, Python, etc.) qui s'exécutent directement dans Raycast sans étape de build ni dépendances. Ils sont parfaits pour les automatisations terminal rapides. Les extensions sont des applications React/TypeScript complètes avec des composants UI riches — listes, formulaires, vues détaillées, panneaux d'action. Utilisez les Script Commands pour les tâches simples produisant une sortie texte. Utilisez les extensions quand vous avez besoin d'une interface interactive.

Raycast Script Commands peut-il accepter des entrées utilisateur ?

Oui. Vous pouvez définir jusqu'à trois arguments dans l'en-tête de métadonnées du script via les champs @raycast.argument1, @raycast.argument2 et @raycast.argument3. Chaque argument spécifie un type et un texte d'espace réservé. Lorsque vous exécutez la commande, Raycast affiche des champs de saisie pour chaque argument. Les valeurs sont transmises à votre script sous forme de paramètres positionnels ($1, $2, $3 en Bash) ou de variables d'environnement.

Ai-je besoin de Raycast Pro pour utiliser Script Commands ?

Non. Script Commands est disponible sur le plan Raycast gratuit sans limitations. Vous pouvez créer, importer et exécuter un nombre illimité de Script Commands sans abonnement. Cela dit, Raycast Pro ajoute des fonctionnalités comme AI Commands et Cloud Sync qui se marient bien avec les workflows basés sur des scripts — notamment l'IA pour générer et déboguer des scripts. Obtenez l'offre Pro actuelle ici.

Comment partager des Script Commands avec mon équipe ?

Les Script Commands sont de simples fichiers sur disque, donc le partage est simple. La meilleure approche consiste à garder vos scripts dans un dépôt Git partagé que les membres de l'équipe clonent avant de pointer Raycast dessus. La communauté Raycast maintient aussi un dépôt open-source script-commands sur GitHub avec des centaines de scripts communautaires. Pour importer un script, placez-le dans n'importe quel répertoire configuré comme dossier Script Commands dans Raycast.