Flowsery CLI
Usa Flowsery dal terminale o da uno script. Un solo binario, nessun runtime da gestire, e ogni comando può restituire JSON.
Installazione
Scegli il metodo più adatto alla tua macchina. Con Homebrew e curl installi un binario autonomo, quindi Node non serve.
npm install -g @flowsery/clibrew trust Flowsery/tap && brew install Flowsery/tap/flowserycurl -fsSL https://flowsery.com/install.sh | shnpx -p @flowsery/cli flowsery --helpHomebrew 7 si rifiuta di caricare una formula da un tap di terze parti finché non lo consideri attendibile, ed è proprio ciò che fa brew trust. Se lo salti, sia l'installazione sia l'aggiornamento si fermano con "Refusing to load formula from untrusted tap".
L'installazione ti dà due nomi per lo stesso programma. Quello breve è fsy.
Autenticazione
Crea un token API e passalo a login. I token si trovano nelle impostazioni del tuo workspace: API e agenti AI.
flowsery loginIl comando apre la pagina dei token, legge il token da un prompt nascosto, controlla il prefisso flow_ws_ in locale, poi lo verifica con una chiamata API prima di scriverlo su disco con permessi 0600. Se il controllo fallisce non viene salvato nulla.
In CI, passa il token tramite pipe e salta il prompt
echo "$MY_SECRET" | flowsery login --token-stdinOppure non salvarlo affatto e passalo a ogni comando
FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoamiAvvio rapido
Una settimana di traffico, i referrer principali in un mese, poi una vista dal vivo che si aggiorna.
flowsery stats --range 7d
flowsery breakdown referrers --range 30d --limit 10
flowsery liveComandi
Ogni comando accetta --help e la maggior parte accetta --json. Se qualcosa non va, esegui prima flowsery doctor.
Accesso
| flowsery login | Salva un token API su questa macchina, dopo aver verificato che funziona |
| flowsery logout | Rimuovi il token salvato |
| flowsery whoami | Mostra quale token è in uso e cosa può vedere |
Uso quotidiano
| flowsery site | I siti su cui questo token può riportare dati |
| flowsery stats | Traffico, entrate e dati in tempo reale |
| flowsery breakdown | Visitatori ed entrate raggruppati per una dimensione |
| flowsery goal | Obiettivi completati e le scritture che li registrano |
| flowsery payment | Scritture delle entrate |
| flowsery issue | Problemi delle sessioni rilevati dall'AI |
| flowsery visitor | Un visitatore, la sua identità, le entrate e la cronologia |
| flowsery live | Una dashboard che si aggiorna per un sito |
Vie di fuga
| flowsery api | Invia una richiesta autenticata a qualsiasi endpoint dell'API |
| flowsery mcp | Stampa la configurazione del server MCP per il tuo editor |
| flowsery open | Apri una pagina della web app nel browser |
Questa macchina
| flowsery config | Leggi e scrivi le preferenze della CLI |
| flowsery doctor | Controlla questa macchina, i file di configurazione, l'API e il sito predefinito |
| flowsery completion | Stampa lo script di completamento per la shell |
Ogni comando elenca i propri flag sotto flowsery <command> --help.
Scripting
Aggiungi --json a qualsiasi comando e ottieni un formato stabile con ok, command e data, pronto per jq.
flowsery whoami --jsonRaramente ti serve il flag. L'output passa da solo a JSON quando stdout non è un terminale o quando CI è impostata, quindi un comando in pipe ti dà già JSON.
Exit code
| 0 | Successo |
| 2 | Errore di utilizzo, ad esempio un flag mancante o sconosciuto |
| 3 | Il token è stato rifiutato o manca |
| 4 | Nessun risultato per quell'ID |
| 5 | L'API ha rifiutato l'input |
| 7 | Troppe richieste |
| 8 | Errore di rete o timeout |
| 9 | Raggiunto il limite del piano o della quota |
Prossimi passi
Crea un token, oppure collega lo stesso account a un agente AI.