Ir al contenido

Documentación Hub

Scripts

Un script es un script de shell o de PowerShell que VMPal guarda en su Hub. Se ejecuta en tu Mac, en una máquina virtual o en un clon nuevo de una máquina virtual, como un runner de CI limpio, pero con tu propia configuración y tus propios datos. Ejecútalo desde el Hub, o haz que lo ejecute tu agente de IA o vmpal.

Pregúntale a tu agente de IA

La forma más sencilla de escribir y ejecutar un script es pedírselo a tu agente de programación. Escribe el script y lo guarda en el Hub de VMPal. Lo ejecuta donde le digas y lee el registro cuando falla una ejecución. Para ello usa las herramientas MCP de VMPal, o vmpal script en su terminal.

  1. En VMPal, abre Ajustes › Agentes de IA y activa Permitir que los agentes de programación de este Mac gestionen todas las máquinas virtuales.
  2. Haz clic en Añadir a Claude Code o en el botón de otro agente (cuáles), y reinicia el agente.
  3. Pídele, por ejemplo:
    • “Escribe un script de VMPal que compile esta app en mi máquina virtual de Windows y ejecútalo ahora.”
    • “Ejecuta mi script de pruebas y dime por qué ha fallado.”
    • “Haz que mi script de compilación se ejecute en un clon nuevo de mi máquina virtual de Ubuntu y que se detenga a los 30 minutos.”

El resto de esta página explica cómo funcionan los scripts, por si quieres saberlo.

Crea uno

VMPal guarda tus scripts en su Hub.

  1. Abre el Hub. Haz clic en Hub en la barra de herramientas de la ventana de VMPal, o elige Visualización › Hub (⌘2).
  2. Haz clic en Nuevo script. Ponle nombre, elige su lenguaje, escríbelo y haz clic en Crear. Un script nuevo empieza con un comentario que enumera sus variables.
  3. Elige dónde se ejecuta. Haz clic en Seleccionar… junto a Se ejecuta en, en la barra lateral. O abre el menú del script (haz clic con el botón derecho en el script o haz clic en ⋯) y elige Cambiar dónde se ejecuta….

En la lista del Hub, haz doble clic en un script o pulsa Retorno para editarlo, pulsa Eliminar para eliminarlo, y arrástralo hacia arriba o hacia abajo para reordenar la lista. En la lista de máquinas virtuales de VMPal, una máquina virtual en la que se ejecutan scripts muestra una marca de script. Haz clic en ella para verlos en el Hub.

Dónde se ejecuta

Un script puede ejecutarse en un clon nuevo de una máquina virtual, en la propia máquina virtual o en tu Mac. Si eliges más de un lugar, se ejecuta en cada uno.

Las ejecuciones en una máquina virtual necesitan el control por agentes, así que VMPal lo activa en cada máquina virtual en la que se ejecuta un script.

Un clon nuevo de una máquina virtual

Es la opción predeterminada para una máquina virtual. Un clon es una copia desechable de la máquina virtual, como un runner de CI recién creado. Cada ejecución recibe su propio clon, y VMPal lo elimina después de la ejecución.

  • Es ligero. VMPal crea el clon al instante. Los clones ligeros necesitan APFS. Para una máquina virtual en una unidad que no es APFS, las ejecuciones usan la propia máquina virtual.
  • La máquina virtual debe estar apagada. Usa Apagar en la máquina virtual. Cerrar su ventana guarda la máquina virtual en lugar de apagarla.
  • Una ejecución espera hasta 30 minutos a que la máquina virtual se apague. Pasado ese tiempo, VMPal omite la ejecución.
  • El clon no tiene nada de tu Mac. No recibe carpetas compartidas, puertos reenviados ni portapapeles.

La propia máquina virtual

Para ejecutarlo en la propia máquina virtual, desmarca Clonar una nueva máquina virtual en cada ejecución debajo de la máquina virtual cuando elijas dónde se ejecuta el script. Entonces, la barra lateral muestra Se ejecuta en la propia máquina virtual debajo de la máquina virtual.

  • VMPal inicia o reanuda la máquina virtual en segundo plano. Inicia sesión en la pantalla de inicio de sesión con la contraseña que guarda VMPal. Deja la máquina virtual en marcha después de la ejecución.
  • Si la máquina virtual está en pausa, la ejecución espera hasta que se reanude.
  • La ejecución usa las carpetas compartidas, el portapapeles y la red de la propia máquina virtual, tal como los configuraste.

Este Mac

El script se ejecuta en tu Mac, como tú. Scripts en este Mac decide si vmpal y los agentes de IA pueden hacer que un script se ejecute aquí.

Cómo se ejecuta

Cada script se ejecuta con el shell del lugar donde se ejecuta:

Dónde Lenguaje Se ejecuta con
Máquina virtual de Linux Shell bash
Máquina virtual de macOS Shell zsh
Tu Mac Shell zsh, o el intérprete de su línea #!
Máquina virtual de Windows PowerShell Windows PowerShell
  • Un script de shell se ejecuta como shell de inicio de sesión, desde la carpeta de inicio.
  • Las ejecuciones usan la cuenta del usuario, no root. Leen los archivos del shell de inicio de sesión: ~/.profile en Linux (no ~/.bashrc), y ~/.zprofile en macOS y en tu Mac (no ~/.zshrc). Así que instala tus herramientas para todos los usuarios, o define el PATH en esos archivos.
  • El código de salida decide si una ejecución es correcta. El código 0 significa que es correcta. Cualquier otro significa que ha fallado.
  • PowerShell sigue adelante cuando falla un programa. Así que comprueba $LASTEXITCODE después de cada uno.
  • VMPal no copia nada de tu Mac salvo el script. Tu script obtiene tu código por su cuenta, por ejemplo con git clone.

Ejecútalo

Haz clic en Ejecutar ahora en la barra lateral o en el menú del script. El script se ejecuta en cada lugar que elegiste. Si todavía no has elegido ninguno, VMPal te pregunta dónde.

Para ejecutarlo en otro lugar, mantén pulsada la tecla Opción en el menú del script y elige Ejecutar en…. VMPal te pregunta primero dónde. Ejecuta el script allí y, a partir de entonces, lo sigue ejecutando allí.

Historial

Historial, en la barra lateral, enumera cada ejecución. Muestra el estado de la ejecución, cuánto duró y por qué falló o está esperando.

  • Mostrar registro abre la salida de una ejecución.
  • Detener detiene una ejecución. Detener ejecuciones, en el menú del script, las detiene todas.
  • Haz doble clic en un elemento para verlo entero, con el registro de cada ejecución a medida que llega.

Registros

Los registros están en tu Mac, en ~/Library/Logs/VMPal/Hub. En el Hub, Ayuda › Mostrar registros en el Finder abre los registros del script.

  • VMPal limita cada registro a 16 MiB. Un registro más largo conserva su principio y su final.
  • VMPal conserva las 50 últimas ejecuciones terminadas de cada script, con sus registros.

Salir de VMPal

Si hay ejecuciones en curso cuando sales de VMPal, primero te pregunta, con Detener ejecuciones y salir. Después detiene las ejecuciones y elimina sus clones. Las ejecuciones que siguen en espera cuando VMPal se cierra nunca se inician. Y no se inicia nada mientras haya una actualización pendiente de instalar.

Sus ajustes

Para cambiar los ajustes de un script, elige Editar script… en su menú, o haz clic en Editar… junto a su nombre en la barra lateral.

Ajuste Qué hace
Lenguaje Shell, o PowerShell para máquinas virtuales de Windows
Tiempo límite VMPal detiene una ejecución que dura más. Elige entre 5 minutos y 6 horas. De forma predeterminada es 1 hora. Con vmpal, puedes definir hasta 24 horas
Color Tiñe la fila del script en el Hub y la marca de script de las máquinas virtuales en las que se ejecuta. Elige uno de los colores del Mac, o ninguno. Color en el menú del script, y el botón de color junto a su nombre en la barra lateral, también lo cambian

En el menú del script, Duplicar coloca una copia del script justo detrás de él. Eliminar script… elimina el script, sus ejecuciones y sus registros.

Las variables

Cada ejecución recibe estas variables de entorno:

Variable Valor
VMPAL_SCRIPT_NAME El nombre del script
VMPAL_RUN_ID El ID de la ejecución
VMPAL_TARGET Dónde se ejecuta: mac, o el nombre de la máquina virtual

En PowerShell, son $env:VMPAL_SCRIPT_NAME, etc.

Límites

  • Una ejecución a la vez en cada lugar. En cada lugar donde se ejecuta, un script solo tiene una ejecución en curso y, como mucho, otra en espera. Una ejecución más reciente ocupa el lugar de la que estaba en espera.
  • Dos clones a la vez. Como máximo, hay dos ejecuciones en clones al mismo tiempo. El siguiente clon de una máquina virtual de un script espera hasta que VMPal elimina el anterior.
  • Dos máquinas virtuales de macOS a la vez. macOS permite como máximo dos máquinas virtuales de macOS a la vez, incluidas las que ejecutas tú. Cuando hay dos en marcha, una ejecución en una máquina virtual de macOS espera a que se detenga una.
  • La propia máquina virtual admite una ejecución a la vez, sea cual sea su script. Un script que se ejecuta en la propia máquina virtual puede tener como máximo 32.000 bytes (en UTF-8). VMPal omite las ejecuciones de un script más largo, así que ejecútalo en un clon.
  • 30 minutos para empezar. VMPal omite una ejecución que lleva 30 minutos esperando para empezar, por ejemplo, a que su máquina virtual se apague.

Scripts en este Mac

Un script en tu Mac ejecuta código como tú. Por eso, VMPal comprueba un ajuste cuando vmpal o un agente de IA harían que un script se ejecutara en tu Mac, es decir, cuando pretenden:

  • añadir tu Mac a los lugares donde se ejecuta un script
  • ejecutar allí un script ahora
  • cambiar el texto de un script que se ejecuta allí

El ajuste es Ajustes › Agentes de IA › Scripts en este Mac:

Opción Qué hace VMPal
Permitir (los agentes te preguntan) La opción predeterminada. VMPal lo permite sin preguntarte. A los agentes se les indica que te pregunten primero, pero VMPal no puede comprobarlo. Así que cualquier app de tu Mac podría ejecutar código como tú de esta forma
Preguntar en VMPal VMPal te muestra el texto del script y dónde se ejecuta, y te pregunta. Pregunta una vez por cada versión del script
Desactivado VMPal lo rechaza

El ajuste no cambia los scripts en máquinas virtuales ni lo que haces en el Hub.

Con vmpal

vmpal es la herramienta de línea de comandos de VMPal, como docker o gh. Sus comandos vmpal script hacen lo mismo que el Hub:

Comando Qué hace
vmpal script create <name> --file <path> Guarda un script. Elige dónde se ejecuta con --run-in <VM> para un clon nuevo de la máquina virtual, --run-in-place <VM> para la propia máquina virtual y --host para este Mac
vmpal script run <script> --wait Lo ejecuta ahora y espera a sus ejecuciones. Su código de salida indica si fueron correctas
vmpal script log <script> Muestra la salida de la ejecución más reciente
vmpal script runs <script> Enumera sus ejecuciones, con sus estados y por qué fallaron
vmpal script edit <script> Cambia su texto, sus ajustes o dónde se ejecuta
vmpal script create "Build" --file build.sh --timeout 30m --run-in "Ubuntu"
vmpal script run "Build" --wait
vmpal script log "Build"

Comandos enumera el resto. Los agentes de IA hacen lo mismo con las herramientas MCP de VMPal, como vmpal_create_script, vmpal_run_script y vmpal_get_run_log. Necesitan que esté activado Permitir que los agentes de programación de este Mac gestionen todas las máquinas virtuales.