---
title: "Flowsery CLI"
description: "Installez le CLI Flowsery, connectez-vous avec un jeton d'API et pilotez tout Flowsery depuis votre terminal ou un script. Sortie JSON et vrais codes de sortie."
url: "https://flowsery.com/fr/features/cli/docs"
---

[Retour aux agents IA](https://flowsery.com/fr/features/agents)

# Flowsery CLI

Pilotez Flowsery depuis votre terminal ou un script. Un seul binaire, aucun runtime à gérer, et chaque commande peut afficher du JSON.

## Installation

Prenez celle qui convient à votre machine. Homebrew et le script curl installent un binaire autonome : Node n'est pas nécessaire.

npm

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

Homebrew (macOS, Linux)

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

Script d'installation (macOS, Linux)

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

Lancer une fois, sans installer

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

Homebrew 7 refuse de charger une formule d'un tap tiers tant que vous ne l'avez pas approuvé, ce que fait brew trust. Sans cela, install et upgrade s'arrêtent sur « Refusing to load formula from untrusted tap ».

L'installation vous donne deux noms pour le même programme. Le court est `fsy`.

## Authentification

Créez un jeton d'API et donnez-le à login. Les jetons vivent dans les réglages de votre espace de travail : [API et agents IA](https://flowsery.com/fr/api-tokens).

```
flowsery login
```

La commande ouvre la page des jetons, lit le jeton dans une invite masquée, vérifie le préfixe `flow_ws_` en local, puis le valide par un appel API avant de l'écrire sur disque en mode 0600\. Rien n'est enregistré si la vérification échoue.

En CI, passez le jeton par un tube et sautez l'invite

```
echo "$MY_SECRET" | flowsery login --token-stdin
```

Ou ne stockez rien et passez-le à chaque commande

```
FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoami
```

## Démarrage rapide

Une semaine de trafic, les meilleurs référents sur un mois, puis une vue en direct.

```
flowsery stats --range 7d
flowsery breakdown referrers --range 30d --limit 10
flowsery live
```

## Commandes

Chaque commande accepte --help, et la plupart acceptent --json. Lancez flowsery doctor si quelque chose cloche.

Se connecter

| flowsery login  | Enregistrer un jeton d'API sur cette machine, après avoir vérifié qu'il fonctionne |
| --------------- | ---------------------------------------------------------------------------------- |
| flowsery logout | Supprimer le jeton enregistré                                                      |
| flowsery whoami | Afficher quel jeton est utilisé et ce à quoi il donne accès                        |

Travail quotidien

| flowsery site      | Les sites sur lesquels ce jeton peut produire des rapports |
| ------------------ | ---------------------------------------------------------- |
| flowsery stats     | Trafic, revenus et chiffres en temps réel                  |
| flowsery breakdown | Visiteurs et revenus regroupés par une dimension           |
| flowsery goal      | Objectifs atteints, et les écritures qui les enregistrent  |
| flowsery payment   | Écritures de revenus                                       |
| flowsery issue     | Problèmes de session détectés par IA                       |
| flowsery visitor   | Un visiteur, son identité, ses revenus et sa chronologie   |
| flowsery live      | Un tableau de bord qui se rafraîchit pour un site          |

Portes de sortie

| flowsery api  | Envoyer une requête authentifiée vers n'importe quel endpoint de l'API |
| ------------- | ---------------------------------------------------------------------- |
| flowsery mcp  | Afficher la configuration du serveur MCP pour votre éditeur            |
| flowsery open | Ouvrir une page de l'application web dans votre navigateur             |

Cette machine

| flowsery config     | Lire et modifier les préférences du CLI                                            |
| ------------------- | ---------------------------------------------------------------------------------- |
| flowsery doctor     | Vérifier cette machine, les fichiers de configuration, l'API et le site par défaut |
| flowsery completion | Afficher le script de complétion du shell                                          |

Chaque commande liste ses propres options sous `flowsery <command> --help`.

## Scripts

Ajoutez --json à n'importe quelle commande et vous obtenez une enveloppe stable avec ok, command et data, prête pour jq.

```
flowsery whoami --json
```

Vous avez rarement besoin de l'option. La sortie passe en JSON d'elle-même quand stdout n'est pas un terminal ou que CI est défini : une commande dans un tube renvoie donc déjà du JSON.

Codes de sortie

| 0 | Succès                                                       |
| - | ------------------------------------------------------------ |
| 2 | Erreur d'usage, par exemple une option manquante ou inconnue |
| 3 | Le jeton a été refusé ou est absent                          |
| 4 | Aucun élément ne correspond à cet identifiant                |
| 5 | L'API a refusé les données                                   |
| 7 | Trop de requêtes                                             |
| 8 | Panne réseau ou délai dépassé                                |
| 9 | Limite de forfait ou de quota atteinte                       |

## Et ensuite

Créez un jeton, ou branchez plutôt le même compte sur un agent IA.

[Créer un jeton d'API](https://flowsery.com/fr/api-tokens)[Agents IA et MCP](https://flowsery.com/fr/features/agents)