Alessandro Aiello IT · EN · ES · FR · DE

Guía

Cómo funciona Statio Deploy, desde la primera app hasta la última variable del .env. Cada sección se sostiene sola: lee la que necesites.

La interfaz de la app está en italiano: esta guía da los nombres de botones y campos tal como aparecen en pantalla, con su significado entre paréntesis.

Añadir una app

El botón + en la parte superior de la lista abre la hoja Nuovo applicativo (nueva app). Los campos son pocos:

Una app se cambia con Modifica… (editar) y se quita con Elimina… (eliminar): desaparece de la lista, pero la carpeta del proyecto no se toca.

La detección de comandos

En cuanto eliges la carpeta, o con el botón Rileva (detectar), Statio Deploy lee los archivos del proyecto y propone los comandos que encuentra, del más probable al menos probable. Un clic en una propuesta la copia en el campo Comando.

Reconoce los scripts de package.json (y elige npm, pnpm, yarn o bun según el lockfile), los proyectos Django, FastAPI y Streamlit, los puntos de entrada de Python con .venv, Poetry o uv, los objetivos del Makefile, Docker Compose, los scripts de shell, el Procfile y los bloques de código del README.

La detección solo lee: no ejecuta nada. Si no encuentra nada, escribes tú el comando.

Iniciar y detener

La ventana principal de Statio Deploy: la lista de apps a la izquierda y, a la derecha, Shop en marcha con su log de Next.js.

Avvia (iniciar, ⌘R) ejecuta el comando en tu shell de inicio de sesión, la misma de Terminal: valen tu PATH, nvm, pyenv y todo lo que tienes en .zprofile y .zshrc. Debajo, el panel Log muestra la salida en directo. Con Segui (seguir) activado, el log se desplaza solo hasta la última línea; Svuota (vaciar) lo limpia.

Arresta (detener, ⌘.) detiene la app y todos los procesos que ha lanzado, no solo el primero: cada app se ejecuta en su propio grupo de procesos. Primero le pide que se cierre con calma; a los cinco segundos, si hace falta, la fuerza. Riavvia (reiniciar, ⇧⌘R) hace las dos cosas seguidas. Ferma tutto (detener todo, ⌥⌘.) detiene todas las apps activas.

Cuando sales de Statio Deploy, las apps que siguen en marcha se detienen.

Apri nel browser (abrir en el navegador, ⌘O) abre la dirección de la app. La dirección puede contener variables leídas de los archivos .env del proyecto: http://localhost:${PORT} usa el valor de PORT, y ${PORT:-3000} usa 3000 si la variable no existe. Así, si cambias el puerto en el .env, el enlace lo sigue.

El navegador se elige en tres niveles: el indicado en la app, si no el predeterminado en los Ajustes de Statio Deploy, si no el del sistema. El menú Apri con (abrir con) lo elige para una sola vez.

Editar el .env

El editor del archivo .env de Shop, con las claves secretas ocultas.

El panel Ambiente (entorno), junto a Log, muestra las variables de los archivos de entorno de la app, un archivo cada vez. Puedes cambiar un valor, añadir una variable al final o eliminar una (y Ripristina, restaurarla, hasta que guardes). Salva (guardar, ⌘S) escribe el archivo.

El resto del archivo no cambia ni un byte: comentarios, líneas vacías, comillas, export y finales de línea se quedan como los escribiste. Las líneas que la app no sabe interpretar se quedan ahí, intactas, y los valores de varias líneas se ven pero no se editan: para ellos está Apri nell'editor (abrir en el editor).

Si otro programa modifica el archivo mientras lo editas, Statio Deploy se da cuenta y, antes de guardar, te pregunta si Ricarica (recargar) la versión del disco o Sovrascrivi (sobrescribirla). Antes de cada guardado, la versión anterior se copia en los datos de Statio Deploy, fuera del proyecto.

Statio Deploy no pasa las variables a la app: es la propia app la que lee su .env al arrancar. Por eso, si lo cambias mientras está en marcha, aparece la invitación a reiniciarla.

Los puertos ocupados

Sales Dashboard detenida, con el aviso de que el puerto 8501 lo ocupa un proceso python.

Antes de iniciar una app, Statio Deploy mira el puerto de su dirección. Si ya está en uso te dice por quién, otra app de Statio Deploy o un proceso ajeno, y te deja elegir: detener el otro proceso, iniciar de todos modos o cancelar.

Una app detenida cuyo puerto está ocupado también muestra un aviso en la lista: normalmente es una copia que quedó en marcha en una terminal.

Barra de menús, Dock y notificaciones

El panel de la barra de menús: las apps con su estado, los botones para abrirlas, iniciarlas o detenerlas, y detener todo.

La forma más rápida de usar Statio Deploy es el panel de la barra de menús. El icono (una pila de tarjetas, con un punto cuando algo está en marcha) lo abre con todas las apps en columna: para cada una, el punto de estado, el nombre, el botón para abrirla en el navegador, si tiene dirección, y el de iniciarla o detenerla. Un clic en el nombre abre la ventana principal ya en esa app. Arriba está el número de apps activas; abajo Ferma tutto (detener todo), Apri Statio Deploy (abrir Statio Deploy) y Esci da Statio Deploy (salir). El panel funciona también con la ventana principal cerrada, y se oculta desde los Ajustes.

El icono del Dock muestra el número de apps activas. Si una app se detiene sola, llega una notificación: un clic y Statio Deploy se abre en esa app, con el log que dice por qué.

Los procesos que quedaron en marcha

Statio Deploy lleva la cuenta de los procesos que inicia. Si se cierra de forma inesperada (un fallo, un apagado forzado), al volver a abrirse encuentra las apps que quedaron en marcha y te lo indica con un aviso: puedes detenerlas o ignorarlas. Su log ya no está disponible, porque no es posible volver a engancharse a un proceso iniciado antes.

Los agentes de IA

Statio Deploy incluye un servidor MCP, el protocolo con el que los agentes de IA usan herramientas externas. Conectado a Claude Code, Claude Desktop, Cursor, Codex u otro cliente MCP, el agente puede listar las apps, leer su estado, logs y .env, buscar los comandos de un proyecto y, si lo permites, iniciar, detener, añadir y editar apps por ti.

Viene apagado: se enciende en Ajustes › Agenti AI (agentes de IA) con Consenti agli agenti AI di gestire Statio Deploy (permitir que los agentes gestionen Statio Deploy). Debajo, los Permessi (permisos) van por grupos: leer apps, estado, logs y .env; iniciar, detener y abrir apps; añadir, editar y quitar apps; editar los archivos .env. Salvo la lectura, cada grupo sigue apagado hasta que lo enciendes.

Los valores de las claves que contienen SECRET, TOKEN, PASSWORD, KEY, PRIVATE o CREDENTIAL llegan al agente ocultos, en los .env y en los logs, salvo que actives Consenti di leggere i valori sensibili (permitir leer valores sensibles). Con Chiedi conferma per le azioni a rischio (pedir confirmación para acciones de riesgo, activado de serie) Statio Deploy te pide permiso antes de iniciar un comando que nunca iniciaste tú o que un agente cambió, y antes de detener todo. Añadir apps, cambiar su comando o carpeta, quitarlas y eliminar variables siempre pide confirmación.

En Configura un client (configurar un cliente) eliges tu cliente y copias la configuración lista; para Claude Desktop está Aggiungi a Claude Desktop (añadir a Claude Desktop). La conexión pasa por un pequeño programa dentro de la app y no abre puertos de red. Para los clientes que no pueden lanzar programas locales está el Server HTTP locale (servidor HTTP local): escucha solo en 127.0.0.1 y pide un token. Los agentes que viven solo en el navegador, como ChatGPT en la web, no pueden conectarse. El Registro attività (registro de actividad) lista cada operación de los agentes, con cliente, hora y resultado.

Ajustes y datos

En los Ajustes (⌘,) eliges el tema (sistema, claro u oscuro), el navegador predeterminado, el icono de la barra de menús, las notificaciones y la apertura al iniciar sesión. Si macOS pide aprobarla, la encontrarás en Ajustes del Sistema, en Ítems de inicio de sesión.

Todos los datos están en ~/Library/Application Support/Local Deploy/: la lista de apps (apps.json), las copias de los .env editados (env-backups/, las diez últimas por archivo) y los procesos iniciados (running.json). La carpeta conserva el nombre original de la app, para que los datos de quien ya la usaba sigan donde están.