Retour aux agents IA

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.

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 loginEnregistrer un jeton d'API sur cette machine, après avoir vérifié qu'il fonctionne
flowsery logoutSupprimer le jeton enregistré
flowsery whoamiAfficher quel jeton est utilisé et ce à quoi il donne accès

Travail quotidien

flowsery siteLes sites sur lesquels ce jeton peut produire des rapports
flowsery statsTrafic, revenus et chiffres en temps réel
flowsery breakdownVisiteurs et revenus regroupés par une dimension
flowsery goalObjectifs atteints, et les écritures qui les enregistrent
flowsery paymentÉcritures de revenus
flowsery issueProblèmes de session détectés par IA
flowsery visitorUn visiteur, son identité, ses revenus et sa chronologie
flowsery liveUn tableau de bord qui se rafraîchit pour un site

Portes de sortie

flowsery apiEnvoyer une requête authentifiée vers n'importe quel endpoint de l'API
flowsery mcpAfficher la configuration du serveur MCP pour votre éditeur
flowsery openOuvrir une page de l'application web dans votre navigateur

Cette machine

flowsery configLire et modifier les préférences du CLI
flowsery doctorVérifier cette machine, les fichiers de configuration, l'API et le site par défaut
flowsery completionAfficher 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

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

Et ensuite

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