---
title: "Flowsery CLI"
description: "Installieren Sie das Flowsery CLI, melden Sie sich mit einem API-Token an und steuern Sie Flowsery vollständig aus dem Terminal oder einem Skript...."
url: "https://flowsery.com/de/features/cli/docs"
---

[Zurück zu KI-Agenten](https://flowsery.com/de/features/agents)

# 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

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

Homebrew (macOS, Linux)

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

Installationsskript (macOS, Linux)

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

Einmal ausführen, ohne Installation

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

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

```
flowsery login
```

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

Oder gar nichts speichern und es pro Befehl mitgeben

```
FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoami
```

## Schnellstart

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

## Befehle

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

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

[API-Token erstellen](https://flowsery.com/de/api-tokens)[KI-Agenten und MCP](https://flowsery.com/de/features/agents)