---
title: "Flowsery CLI: usa Flowsery dal terminale"
description: "Installa la CLI di Flowsery, accedi con un token API e usa ogni parte di Flowsery dal terminale o da uno script. Output JSON e codici di uscita reali."
url: "https://flowsery.com/it/features/cli/docs"
---

[Torna agli agenti AI](https://flowsery.com/it/features/agents)

# 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

```
npm install -g @flowsery/cli
```

Homebrew (macOS, Linux)

```
brew trust Flowsery/tap && brew install Flowsery/tap/flowsery
```

Script di installazione (macOS, Linux)

```
curl -fsSL https://flowsery.com/install.sh | sh
```

Esegui una volta, senza installare

```
npx -p @flowsery/cli flowsery --help
```

Homebrew 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](https://flowsery.com/it/api-tokens).

```
flowsery login
```

Il 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-stdin
```

Oppure non salvarlo affatto e passalo a ogni comando

```
FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoami
```

## Avvio 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 live
```

## Comandi

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 --json
```

Raramente 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.

[Crea un token API](https://flowsery.com/it/api-tokens)[Agenti AI e MCP](https://flowsery.com/it/features/agents)