Cómo crear comandos personalizados y ajustes preestablecidos en Raycast AI para optimizar tu flujo de trabajo en macOS

Alternar constantemente entre editores de código, la terminal y pestañas del navegador para consultar asistentes de inteligencia artificial interrumpe la concentración. Raycast AI resuelve esta fricción integrando modelos de lenguaje directamente en el sistema operativo a través de su lanzador para macOS. En lugar de copiar texto, abrir el navegador, escribir una instrucción y pegar la respuesta de vuelta, puedes ejecutar tareas de IA a medida en cualquier aplicación con un simple atajo de teclado.

Raycast AI ofrece dos mecanismos fundamentales y complementarios:

1. Comandos personalizados de IA (Custom AI Commands): Acciones directas basadas en prompts que operan sobre el texto seleccionado o el portapapeles, mostrando el resultado en una ventana flotante o reemplazando el texto seleccionado en el lugar.
2. Ajustes preestablecidos y agentes de IA (AI Presets / Agents): Plantillas e instrucciones del sistema persistentes para conversaciones continuas en el chat, configuradas con modelos específicos, niveles de razonamiento y extensiones de herramientas.

En esta guía se detalla cómo crear comandos de IA personalizados, configurar agentes y presets de chat, aprovechar marcadores de posición dinámicos y asignar atajos globales para transformar tu productividad diaria en el escritorio.

1. Creación de comandos personalizados de IA

Los comandos de IA personalizados son ideales para tareas repetitivas y delimitadas, como refactorización de código, traducción, corrección de estilo o explicación de consultas SQL.

Paso a paso para configurarlos

1. Presiona ⌥ Espacio (o tu atajo configurado para Raycast) para abrir el lanzador.
2. Escribe Create AI Command y pulsa Enter. (También puedes buscar Search AI Commands, seleccionar un comando integrado y presionar ⌘D para duplicarlo y editarlo).
3. Completa el formulario de configuración:
   • Name & Icon (Nombre e icono): Asigna un nombre claro y descriptivo (por ejemplo, Refactor to TypeScript o Explain SQL Query) y escoge un icono representativo.
   • Prompt (Instrucción): Redacta la orden para el modelo. Usa { para insertar marcadores dinámicos y @ para invocar extensiones de herramientas.
   • Model (Modelo): Selecciona el modelo que procesará la solicitud (como Claude 3.5 Sonnet, GPT-4o o modelos con capacidades de razonamiento como o1/o3-mini). Si lo dejas vacío, usará el modelo por defecto configurado en Settings → AI → Models & Providers.
   • Creativity (Creatividad / Temperatura): Ajusta entre None, Low, Medium, High o Maximum. Para refactorización de código o análisis estructurado, se recomienda None o Low.
   • Reasoning Effort (Esfuerzo de razonamiento): Permite ajustar el tiempo de procesamiento en modelos con soporte de razonamiento profundo.
   • Output Behavior (Comportamiento de salida):
     • Open in Raycast: Muestra la respuesta en una ventana flotante de Raycast, facilitando la lectura y copia, con la opción de presionar ⌘J para continuar la sesión en el AI Chat completo.
     • Replace Selection: Sobrescribe directamente el texto seleccionado en la aplicación en primer plano con el resultado generado.
   • Highlight Editing Changes (Resaltar cambios): Cuando se usa con Replace Selection, subraya los cambios realizados para verificar las modificaciones.
4. Presiona ⌘ Enter para guardar. El comando estará disponible de inmediato en la barra de búsqueda principal.

2. Dominio de los marcadores de posición dinámicos (Dynamic Placeholders)

Los marcadores dinámicos permiten inyectar contexto de tu entorno de trabajo en los prompts en tiempo de ejecución, eliminando la necesidad de copiar y pegar manualmente.

Modificadores de texto

Puedes encadenar modificadores con una barra vertical para limpiar y transformar la entrada:

• {clipboard | trim}: Elimina espacios en blanco y saltos de línea al inicio y al final.
• {selection | lowercase} o {selection | uppercase}: Normaliza el formato de mayúsculas/minúsculas.
• {selection | json-stringify}: Escapa comillas y caracteres especiales para integrarlos con seguridad en cadenas JSON.
• {clipboard | raw}: Evita que Raycast envuelva automáticamente el contenido entre comillas.

Ejemplos prácticos de comandos de IA

Ejemplo 1: Generador de tipos TypeScript y documentación JSDoc in situ

• Comportamiento de salida: 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.

Ejemplo 2: Generador interactivo de mensajes de Git Commit

• Comportamiento de salida: 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. Configuración de ajustes preestablecidos y agentes de IA

Mientras que los comandos de IA son ideales para tareas puntuales de una sola respuesta, los flujos de desarrollo complejos exigen conversaciones continuas con directrices estrictas de arquitectura y acceso delimitado a herramientas.

En Raycast v1, estas configuraciones se denominaban AI Chat Presets; en Raycast v2 han evolucionado a Agents (Agentes), manteniendo plena compatibilidad con los ajustes existentes y la biblioteca comunitaria Preset Explorer.

Creación de un agente personalizado

1. Abre Settings → AI → Agents (o ejecuta Search Agents y haz clic en Create Agent).
2. Define los parámetros del agente:
   • Name & Icon: Un nombre representativo (ej. Optimizador PostgreSQL o Revisor Senior de Código).
   • Model: Selecciona un LLM específico o escoge Inherit para seguir el modelo activo en la ventana de chat.
   • Instructions (Prompt del sistema): Establece el rol, convenciones de codificación, arquitectura esperada y restricciones.
   • AI Extensions (Extensiones de herramientas): Habilita únicamente las herramientas necesarias para su propósito (por ejemplo, @calendar, @github, @file-search).
3. Presiona ⌘ Enter para guardar.

Acceso a los agentes y presets

• Dentro de AI Chat: Escribe / en el campo de texto para abrir el menú rápido de agentes, o presiona ⌘K → Change Agent.
• Desde la búsqueda principal: Escribe directamente el nombre del agente en Raycast y pulsa Enter para iniciar un nuevo chat con ese perfil.
• Importación comunitaria: Explora presets.ray.so para añadir presets creados por la comunidad en un solo clic.

4. Atajos globales y corrección instantánea con Quick Fix

Para eliminar por completo las interrupciones en tu flujo de trabajo, asocia tus comandos y agentes a atajos de teclado del sistema:

1. Asignación de Hotkeys dedicados:

   • Ve a Settings → Extensions → AI (o presiona ⌘K → Configure Command sobre cualquier elemento).
   • En el campo Hotkey, presiona la combinación deseada (por ejemplo, ⌃⌥C para el generador de commits o ⌃⌥R para refactorizar código).
   • A partir de ese momento, basta con resaltar código en VS Code o Xcode y pulsar ⌃⌥R para transformarlo en el acto, sin abrir la ventana de Raycast.

2. Uso de Quick Fix:

   • Raycast incluye la función integrada Quick Fix, orientada a corregir ortografía y gramática en cualquier campo de texto activo.
   • Por defecto, presionar dos veces seguidas la tecla Shift derecha (Double Right Shift) revisa y reemplaza el texto al instante.
   • En Settings → AI → Quick Fix, activa Preserve Formatting para conservar negritas, hipervínculos y listas al corregir texto en Notion o Slack.

5. Permisos del sistema, planes y gestión de modelos

Permisos de Accesibilidad en macOS

Tanto Replace Selection como Quick Fix requieren interactuar con otras aplicaciones mediante la API de accesibilidad de macOS.

• Abre Ajustes del Sistema → Privacidad y seguridad → Accesibilidad (denominado "Control de dispositivos y acceso a datos" en versiones recientes).
• Asegúrate de habilitar los permisos correspondientes para Raycast.

Precios y opciones BYOK (Bring Your Own Key)

• Raycast Free: Incluye las utilidades esenciales del lanzador (calculadora, snippets, historial de portapapeles y tienda de extensiones).
• Raycast Pro (10 USD/mes o 96 USD/año): Desbloquea Raycast AI con créditos mensuales de IA, sincronización en la nube y comandos personalizados.
• Planes Pro+ y Max: Ofrecen paquetes ampliados de créditos y acceso intensivo a modelos punteros.
• BYOK y suscripciones conectadas: Los usuarios de planes de pago pueden vincular sus propias claves de API de OpenAI, Anthropic, Google y OpenRouter, o conectar directamente sus suscripciones existentes de ChatGPT y Claude, aprovechando la velocidad de la interfaz de Raycast mientras controlan el consumo de cómputo.

La integración de comandos de acción rápida con presets persistentes de chat permite a los usuarios de macOS prescindir de las pestañas del navegador y operar con inteligencia artificial contextual en cada rincón del sistema.

Referencias

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