Raycast Terminal y Script Commands 2026: Ejecuta código desde tu lanzador

La mayoría de desarrolladores vive en la terminal. Commits de Git, contenedores Docker, scripts de despliegue, comandos npm — es pura memoria muscular. Pero cambiar entre Raycast y una ventana de terminal docenas de veces al día añade fricción innecesaria. Raycast Script Commands te permite ejecutar comandos de shell, scripts de bash, código Python y más directamente desde el lanzador de Raycast — sin abrir la terminal.

En esta guía cubro todo sobre ejecutar comandos de terminal desde Raycast en 2026: cómo funcionan los Script Commands, qué lenguajes se admiten, ejemplos prácticos que puedes copiar y cómo integrar Raycast con tus flujos terminales existentes. Si eres nuevo en Raycast, empieza con nuestra guía de configuración de Raycast y luego vuelve aquí.

¿Qué son los Raycast Script Commands?

Los Script Commands son archivos de script independientes que Raycast puede ejecutar directamente desde el command palette. Piensa en ellos como comandos de terminal personalizados con una capa de UI encima. Escribes un script en tu lenguaje preferido, añades una cabecera de metadatos especial y Raycast lo convierte en un comando buscable y ejecutable.

A diferencia de las extensiones de Raycast completas (que usan React y TypeScript), los Script Commands son archivos simples — sin compilación, sin dependencias, sin scaffolding. Por eso son ideales para automatizaciones rápidas y tareas puntuales.

Lenguajes admitidos

Raycast Script Commands admite cualquier lenguaje que pueda ejecutarse desde una línea shebang en macOS:

• Bash / Zsh — la opción más común para comandos del sistema y automatizaciones rápidas
• Python — ideal para scripts que necesitan peticiones HTTP, análisis JSON o procesamiento de datos
• Ruby — popular para manipulación de texto y scripting
• Swift — acceso nativo a las APIs del sistema macOS
• AppleScript — controla apps de macOS como Finder, Safari, Mail y Preferencias del Sistema
• Node.js — usa #!/usr/bin/env node para scripts basados en JavaScript

Si un lenguaje tiene un intérprete instalado en tu Mac y admite línea shebang, funciona con Raycast. La mayoría de desarrolladores se queda con Bash para comandos del sistema y Python para algo más complejo.

Cómo crear tu primer Script Command

Paso 1: Añade un directorio de scripts

Abre Raycast, ve a Settings (o pulsa Cmd + ,), navega a Extensions y haz clic en el botón +. Selecciona "Add Script Directory" y apunta a una carpeta donde guardarás tus scripts. Recomiendo ~/.raycast-scripts/ o mantenerlos en un repo Git para control de versiones.

Paso 2: Crea un archivo de script

Crea un archivo nuevo en tu directorio de scripts. Este es un ejemplo mínimo en Bash que muestra tu rama actual de Git:

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

Los comentarios de metadatos al inicio indican a Raycast cómo mostrar y ejecutar el comando. Los campos clave son:

• @raycast.title — el nombre que aparece en el command palette de Raycast
• @raycast.mode — cómo se muestra la salida: inline (en Raycast), compact (notificación breve), fullOutput (salida desplazable) o silent (sin salida)
• @raycast.packageName — agrupa scripts relacionados

Paso 3: Hazlo ejecutable

No olvides dar permisos de ejecución a tu script:

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

Raycast detecta automáticamente los scripts nuevos en tus directorios configurados. Abre Raycast y escribe el título de tu script — debe aparecer al instante.

Agregar entrada del usuario con argumentos

Los Script Commands pueden aceptar argumentos que Raycast solicita antes de la ejecución. Esto convierte scripts simples en herramientas interactivas:

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

Cuando ejecutas este comando, Raycast muestra un campo de texto para el mensaje del commit. Tras escribirlo y pulsar Enter, el script se ejecuta con tu entrada como $1. Puedes definir hasta tres argumentos por script.

Mejores ejemplos de Script Commands para desarrolladores

Aquí es donde Script Commands se vuelven realmente útiles. Estos son ejemplos prácticos que puedes adaptar a tu flujo.

Atajos de Git

Deja de cambiar a la terminal para operaciones rutinarias de Git:

• Commit rápido — agrega todo y hace commit con un mensaje como argumento
• Pull del último — git pull --rebase origin main en tu proyecto actual
• Crear rama — toma un argumento de nombre, crea y cambia a la rama
• Mostrar estado — git status --short en modo inline dentro de Raycast
• Stash / pop — aplicar y restaurar con una sola pulsación

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

Comandos de Docker

Gestiona contenedores sin salir de tu flujo:

• Listar contenedores en ejecución — docker ps --format "table {{.Names}}\t{{.Status}}" con modo fullOutput
• Detener todos los contenedores — docker stop $(docker ps -q)
• Reconstruir y reiniciar — docker-compose down && docker-compose up -d --build
• Depurar imágenes sin usar — docker system prune -af para recuperar espacio

Scripts de npm y gestores de paquetes

Ejecuta scripts del proyecto desde cualquier lugar:

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

Este abre una ventana de Terminal e inicia el servidor de desarrollo. Para scripts que necesitan una sesión persistente, lanzar una ventana nueva suele ser lo mejor.

Mantenimiento del sistema

• Vaciar DNS — sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• Limpiar caché de Homebrew — brew cleanup --prune=all
• Mostrar uso de disco — df -h / | tail -1 para ver espacio rápidamente
• Matar proceso por nombre — toma un argumento de proceso: pkill -f "$1"
• Vaciar papelera — rm -rf ~/.Trash/* con paso de confirmación

Scripts de despliegue

Dispara despliegues sin abrir una terminal o un navegador:

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

Ejemplo de script en Python

Para algo más allá de comandos básicos, Python es una gran opción. Este script obtiene tu IP pública:

#!/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)

La extensión Run Script

Además de los Script Commands, Raycast también tiene extensiones en la Store que llevan funciones de terminal al lanzador. La extensión Terminal te permite buscar y abrir perfiles de terminal directamente. Varias extensiones de la comunidad ofrecen acceso rápido al historial de shell, conexiones SSH y herramientas CLI comunes.

Explora la lista de mejores extensiones de Raycast para más herramientas que complementan los flujos de terminal. Extensiones como Brew te permiten buscar, instalar y gestionar paquetes de Homebrew totalmente dentro de Raycast — sin terminal.

Integrar Raycast con VS Code y tu terminal

Raycast y tu terminal no tienen por qué ser mundos separados. Aquí tienes formas de conectarlos:

Abre proyectos en VS Code

Crea un Script Command que abra un proyecto específico (o acepte una ruta) en 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 para flujos de terminal

Raycast Quicklinks puede abrir comandos de terminal al instante. Crea un Quicklink con el esquema terminal:// o iterm:// si usas iTerm2. Es incluso más rápido que los Script Commands para comandos simples y frecuentes.

Combinar Script Commands con Raycast AI

Si usas Raycast Pro, puedes combinar AI Commands y Script Commands para flujos poderosos. Pídele a Raycast AI que genere un one-liner en bash y luego ejecútalo con un Script Command. O usa la IA para explicar el error de un script fallido. Es una combinación natural — IA para pensar, Script Commands para hacer.

¿Todavía no tienes Pro? Prueba Raycast Pro con 80% de descuento y prueba gratuita para desbloquear funciones de IA junto a tus scripts.

Script Commands vs. Extensions: cuándo usar cada uno

Ambos pueden ejecutar código, pero sirven propósitos distintos:

• Usa Script Commands cuando: necesitas una automatización rápida, la tarea es un one-liner o script corto, no necesitas UI rica o prefieres Bash/Python en lugar de TypeScript
• Usa extensiones cuando: necesitas listas, formularios o vistas detalladas interactivas, la herramienta requiere gestión de estado compleja, quieres publicarla en la Store de Raycast o necesitas actualizaciones en tiempo real

En la práctica, la mayoría de desarrolladores usa ambos. Script Commands manejan tareas terminales rápidas. Las extensiones cubren las herramientas que usas a diario y requieren experiencia pulida. Si te interesa crear extensiones completas, revisa la guía para desarrolladores de la API de Raycast.

Consejos para escribir mejores Script Commands

Usa el modo fullOutput para salidas largas

Si tu script devuelve más de un par de líneas, usa @raycast.mode fullOutput para que el resultado sea desplazable dentro de Raycast. El modo inline trunca la salida larga.

Maneja los errores con elegancia

Añade comprobaciones para que tus scripts no fallen en silencio. Un patrón rápido 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}}"

Usa variables de entorno

Para scripts que necesitan API keys o tokens, guárdalos en variables de entorno en lugar de hardcodearlos. Raycast hereda tu entorno de shell, así que cualquier cosa en tu .zshrc o .bash_profile está accesible.

Controla versiones de tus scripts

Mantén tu directorio de Script Commands como un repositorio Git. Esto te permite sincronizar scripts entre máquinas, rastrear cambios y compartir con tu equipo. El repositorio comunitario script-commands en GitHub tiene cientos de ejemplos inspiradores.

Combina con Raycast Snippets

Para comandos que escribes frecuentemente en la terminal, considera usar Raycast Snippets. Snippets expande texto en cualquier parte de tu Mac — escribes una palabra clave y se reemplaza por un comando largo. Usa Script Commands para ejecutar y Snippets para expandir texto.

Cómo exprimir Raycast para flujos terminales

Los Script Commands son solo una pieza. Un flujo completo de terminal en Raycast puede incluir:

• Script Commands para ejecutar scripts de shell y automatizaciones
• Quicklinks para saltar a directorios de proyectos o abrir perfiles de terminal
• Snippets para expandir comandos que escribes seguido
• Clipboard History para recuperar salidas de terminal copiadas
• AI Commands (Pro) para generar scripts y depurar errores
• Extensiones para Brew, GitHub, Docker y otras herramientas de desarrollo

Si aún no configuraste Raycast, la página de descuento de Raycast Pro tiene la mejor oferta actual. Y nuestra guía sobre qué es Raycast cubre los fundamentos antes de sumergirte en funciones avanzadas como Script Commands.

Preguntas frecuentes

¿Qué lenguajes puedo usar para Raycast Script Commands?

Raycast admite Bash, Python, Ruby, Swift y AppleScript de forma nativa. Cualquier lenguaje con línea shebang válida que se ejecute en macOS funciona — incluidos Node.js, PHP, Perl y otros. Bash y Python son con diferencia las opciones más populares. Solo asegúrate de que el intérprete esté instalado y el archivo sea ejecutable.

¿Cuál es la diferencia entre Script Commands y Raycast Extensions?

Script Commands son archivos independientes (Bash, Python, etc.) que se ejecutan directo desde Raycast sin compilación ni dependencias. Son perfectos para automatizaciones rápidas de terminal. Las extensiones son aplicaciones completas de React/TypeScript con UI rica — listas, formularios, vistas detalladas, paneles de acciones. Usa Script Commands para tareas simples que producen texto. Usa extensiones cuando necesites una interfaz interactiva.

¿Pueden los Raycast Script Commands aceptar entrada del usuario?

Sí. Puedes definir hasta tres argumentos en la cabecera de metadatos con @raycast.argument1, @raycast.argument2 y @raycast.argument3. Cada argumento especifica un tipo y texto de marcador. Al ejecutar el comando, Raycast muestra campos de entrada para cada argumento. Los valores se pasan como parámetros posicionales ($1, $2, $3 en Bash) o variables de entorno.

¿Necesito Raycast Pro para usar Script Commands?

No. Script Commands está disponible en el plan gratuito de Raycast sin limitaciones. Puedes crear, importar y ejecutar Script Commands ilimitados sin suscripción. Dicho eso, Raycast Pro suma funciones como AI Commands y Cloud Sync que combinan muy bien con flujos basados en scripts — especialmente la IA para generar y depurar scripts. Obtén la oferta Pro actual aquí.

¿Cómo comparto Script Commands con mi equipo?

Script Commands son archivos simples, así que compartirlos es directo. La mejor opción es mantener tus scripts en un repositorio Git compartido que tu equipo clone y conecte a Raycast. La comunidad de Raycast también mantiene un repositorio open-source script-commands en GitHub con cientos de scripts comunitarios. Para importar uno, colócalo en cualquier directorio configurado como carpeta de Script Commands en Raycast.