Flowsery CLI
Steuern Sie Flowsery aus dem Terminal oder einem Skript. Eine Binärdatei, keine Laufzeitumgebung, und jeder Befehl kann JSON ausgeben.
Installation
Nehmen Sie, was zu Ihrem Rechner passt. Homebrew und das curl-Skript installieren eine eigenständige Binärdatei, Node wird nicht gebraucht.
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 lädt eine Formel aus einem fremden Tap erst, wenn Sie ihm vertrauen, und genau das macht brew trust. Ohne diesen Schritt brechen install und upgrade mit „Refusing to load formula from untrusted tap" ab.
Die Installation legt zwei Namen für dasselbe Programm an. Der kurze ist fsy.
Authentifizierung
Erstellen Sie ein API-Token und übergeben Sie es an login. Tokens liegen in den Workspace-Einstellungen: API und KI-Agenten.
flowsery loginDer Befehl öffnet die Token-Seite, liest das Token aus einer verdeckten Eingabe, prüft lokal das Präfix flow_ws_ und bestätigt es mit einem API-Aufruf, bevor er es mit Modus 0600 auf die Platte schreibt. Schlägt die Prüfung fehl, wird nichts gespeichert.
In der CI das Token per Pipe übergeben und die Eingabe überspringen
echo "$MY_SECRET" | flowsery login --token-stdinOder gar nichts speichern und es pro Befehl mitgeben
FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoamiSchnellstart
Eine Woche Traffic, die wichtigsten Referrer über einen Monat, dann eine Live-Ansicht.
flowsery stats --range 7d
flowsery breakdown referrers --range 30d --limit 10
flowsery liveBefehle
Jeder Befehl kennt --help, die meisten auch --json. Führen Sie flowsery doctor aus, wenn etwas nicht stimmt.
Anmelden
| flowsery login | Ein API-Token auf diesem Rechner speichern, nachdem geprüft wurde, dass es funktioniert |
| flowsery logout | Das gespeicherte Token entfernen |
| flowsery whoami | Zeigen, welches Token verwendet wird und worauf es Zugriff hat |
Tägliche Arbeit
| flowsery site | Die Websites, über die dieses Token berichten darf |
| flowsery stats | Traffic, Umsatz und Echtzeitzahlen |
| flowsery breakdown | Besucher und Umsatz nach einer Dimension gruppiert |
| flowsery goal | Erreichte Ziele und die Schreibvorgänge, die sie festhalten |
| flowsery payment | Umsatz-Schreibvorgänge |
| flowsery issue | Von der KI erkannte Session-Probleme |
| flowsery visitor | Ein Besucher, seine Identität, sein Umsatz und sein Verlauf |
| flowsery live | Ein sich aktualisierendes Dashboard für eine Website |
Notausgänge
| flowsery api | Eine authentifizierte Anfrage an einen beliebigen API-Endpunkt senden |
| flowsery mcp | Die MCP-Server-Konfiguration für Ihren Editor ausgeben |
| flowsery open | Eine Seite der Web-App im Browser öffnen |
Dieser Rechner
| flowsery config | CLI-Einstellungen lesen und schreiben |
| flowsery doctor | Diesen Rechner, die Konfigurationsdateien, die API und die Standard-Website prüfen |
| flowsery completion | Das Shell-Completion-Skript ausgeben |
Jeder Befehl listet seine eigenen Optionen unter flowsery <command> --help.
Skripte
Hängen Sie --json an einen beliebigen Befehl und Sie bekommen eine feste Hülle mit ok, command und data, fertig für jq.
flowsery whoami --jsonDie Option brauchen Sie selten. Die Ausgabe wechselt von selbst zu JSON, sobald stdout kein Terminal ist oder CI gesetzt ist. Ein Befehl in einer Pipe liefert also schon JSON.
Exit-Codes
| 0 | Erfolg |
| 2 | Bedienfehler, etwa eine fehlende oder unbekannte Option |
| 3 | Das Token wurde abgelehnt oder fehlt |
| 4 | Zu dieser ID gab es keinen Treffer |
| 5 | Die API hat die Eingabe abgelehnt |
| 7 | Zu viele Anfragen |
| 8 | Netzwerkfehler oder Zeitüberschreitung |
| 9 | Tarif- oder Kontingentgrenze erreicht |
Nächste Schritte
Erstellen Sie ein Token, oder hängen Sie dasselbe Konto stattdessen an einen KI-Agenten.