Guida

Come funziona Statio Deploy, dalla prima app all'ultima variabile del .env. Ogni sezione sta in piedi da sola: leggi quella che ti serve.

Aggiungere un'app

Con il pulsante + in cima all'elenco si apre la scheda Nuovo applicativo. I campi sono pochi:

• Nome: quello che vedi nell'elenco.
• Cartella: la cartella del progetto, scelta con Scegli… o scritta a mano. Il comando parte da qui.
• Comando: quello che scriveresti nel Terminale, per esempio npm run dev.
• Indirizzo: facoltativo, la pagina da aprire nel browser.
• Browser: quello in cui aprire questa app, oppure il predefinito.
• File di ambiente: lasciato vuoto, Statio Deploy usa da solo il .env e i .env.* della cartella. Se il progetto li tiene altrove, scrivi i percorsi relativi alla cartella, separati da virgola.
• Note: quello che vuoi ricordarti del progetto.

Un'app si cambia con Modifica… e si toglie con Elimina…: viene rimossa dall'elenco, ma la cartella del progetto non viene toccata.

Il rilevamento dei comandi

Appena scegli la cartella, o con il pulsante Rileva, Statio Deploy legge i file del progetto e propone i comandi che trova, dal più probabile al meno probabile. Un clic su una proposta la copia nel campo Comando.

Riconosce gli script di package.json (e sceglie npm, pnpm, yarn o bun guardando il lockfile), i progetti Django, FastAPI e Streamlit, i punti d'ingresso Python con .venv, Poetry o uv, i target del Makefile, Docker Compose, gli script shell, il Procfile e i blocchi di codice del README.

Il rilevamento legge e basta: non esegue niente. Se non trova nulla, il comando lo scrivi tu.

Avviare e fermare

Avvia (⌘R) lancia il comando nella tua shell di login, la stessa del Terminale: valgono il tuo PATH, nvm, pyenv e tutto quello che hai in .zprofile e .zshrc. Sotto, il pannello Log mostra l'uscita dal vivo. Con Segui acceso il log scorre da solo fino all'ultima riga; Svuota lo pulisce.

Arresta (⌘.) ferma l'app e tutti i processi che ha lanciato, non solo il primo: ogni app gira in un gruppo di processi suo. Prima arriva la richiesta di chiudersi con calma; dopo cinque secondi, se serve, l'arresto forzato. Riavvia (⇧⌘R) fa le due cose di fila. Ferma tutto (⌥⌘.) ferma tutte le app attive.

Quando esci da Statio Deploy, le app ancora accese vengono fermate.

Aprire nel browser

Apri nel browser (⌘O) apre l'indirizzo dell'app. L'indirizzo può contenere variabili lette dai file .env del progetto: http://localhost:${PORT} usa il valore di PORT, e ${PORT:-3000} usa 3000 se la variabile non c'è. Così, se cambi la porta nel .env, il link segue da solo.

Il browser si sceglie a tre livelli: quello indicato nell'app, altrimenti quello predefinito nelle Impostazioni di Statio Deploy, altrimenti quello di sistema. Dal menu Apri con lo scegli per una volta sola.

Modificare il .env

Il pannello Ambiente, accanto a Log, mostra le variabili dei file di ambiente dell'app, uno per volta. Puoi cambiare un valore, aggiungere una variabile in fondo o eliminarne una (e Ripristinala, finché non salvi). Salva (⌘S) scrive il file.

Il resto del file non cambia di un byte: commenti, righe vuote, virgolette, export e fine riga restano come li avevi scritti. Le righe che l'app non sa interpretare restano lì, intatte, e i valori su più righe si vedono ma non si modificano: per quelli c'è Apri nell'editor.

Se un altro programma modifica il file mentre lo stai cambiando, Statio Deploy se ne accorge e prima di salvare ti chiede se Ricaricare la versione sul disco o Sovrascriverla. Prima di ogni salvataggio, la versione precedente viene copiata fra i dati di Statio Deploy, fuori dal progetto.

Statio Deploy non passa le variabili all'app: è l'app stessa a leggere il suo .env quando parte. Per questo, se la modifichi mentre è accesa, compare l'invito a riavviarla.

Le porte occupate

Prima di avviare un'app, Statio Deploy guarda la porta del suo indirizzo. Se è già presa ti dice da chi, che sia un'altra app di Statio Deploy o un processo estraneo, e ti lascia scegliere: fermare l'altro processo, avviare comunque o annullare.

Anche un'app ferma la cui porta risulta occupata mostra un avviso nell'elenco: di solito è una copia rimasta accesa in un terminale.

Barra dei menu, Dock e notifiche

Il modo più rapido di usare Statio Deploy è il pannello nella barra dei menu. L'icona (una pila di schede, con un pallino quando qualcosa è acceso) lo apre con tutte le app in colonna: per ognuna il pallino dello stato, il nome, il pulsante per aprirla nel browser, se ha un indirizzo, e quello per avviarla o fermarla. Un clic sul nome apre la finestra principale già su quell'app. In alto c'è il numero di app attive; in fondo Ferma tutto, Apri Statio Deploy ed Esci da Statio Deploy. Il pannello funziona anche con la finestra principale chiusa, e si nasconde dalle Impostazioni.

L'icona nel Dock mostra il numero di app attive. Se un'app si interrompe da sola, arriva una notifica: un clic e Statio Deploy si apre su quell'app, con il log che dice perché.

I processi rimasti accesi

Statio Deploy tiene nota dei processi che avvia. Se si chiude male (un crash, uno spegnimento forzato), al riavvio ritrova le app rimaste accese e te lo dice con un avviso: puoi fermarle o ignorarle. Il loro log non è più disponibile, perché non è possibile riagganciarsi a un processo avviato prima.

Gli agenti AI

Statio Deploy contiene un server MCP, il protocollo con cui gli agenti AI usano strumenti esterni. Collegato a Claude Code, Claude Desktop, Cursor, Codex o un altro client MCP, l'agente può elencare le app, leggerne stato, log e .env, cercare i comandi di un progetto e, se lo permetti, avviare, fermare, aggiungere e modificare le app al posto tuo.

Di serie è spento: si accende in Impostazioni › Agenti AI con Consenti agli agenti AI di gestire Statio Deploy. Sotto, i Permessi vanno per gruppi: lettura di app, stato, log e .env; avviare, arrestare e aprire le app; aggiungere, modificare e rimuovere app; modificare i file .env. Oltre alla lettura, ogni gruppo resta spento finché non lo accendi.

I valori delle chiavi che contengono SECRET, TOKEN, PASSWORD, KEY, PRIVATE o CREDENTIAL arrivano all'agente mascherati, nei .env e nei log, a meno che tu non accenda Consenti di leggere i valori sensibili. Con Chiedi conferma per le azioni a rischio (acceso di serie) Statio Deploy ti chiede il permesso prima di avviare un comando che non hai mai avviato tu o che un agente ha cambiato, e prima di Ferma tutto. Aggiungere app, cambiarne comando o cartella, rimuoverle ed eliminare variabili chiede sempre conferma.

In Configura un client scegli il tuo client e copi la configurazione pronta; per Claude Desktop c'è Aggiungi a Claude Desktop. Il collegamento passa da un piccolo programma dentro l'app e non apre porte di rete. Per i client che non avviano programmi locali c'è il Server HTTP locale: ascolta solo su 127.0.0.1 e chiede un token. Gli agenti che vivono solo nel browser, come ChatGPT sul web, non possono collegarsi. Il Registro attività elenca ogni operazione degli agenti, con client, ora ed esito.

Impostazioni e dati

Nelle Impostazioni (⌘,) scegli il tema (Sistema, Chiaro o Scuro), il browser predefinito, l'icona nella barra dei menu, le notifiche e l'avvio al login. Se macOS chiede di approvarlo, lo trovi in Impostazioni di Sistema, alla voce Elementi login.

Tutti i dati stanno in ~/Library/Application Support/Local Deploy/: l'elenco delle app (apps.json), le copie dei .env modificati (env-backups/, le ultime dieci per file) e i processi avviati (running.json). La cartella porta ancora il nome originale dell'app, così i dati di chi la usava già restano dove sono.