---
title: "Flowsery CLI"
description: "Instalacja Flowsery CLI, logowanie tokenem API i obsługa wszystkich funkcji Flowsery z terminala lub skryptu. Wyjście JSON i prawdziwe kody wyjścia."
url: "https://flowsery.com/pl/features/cli/docs"
---

[Wróć do agentów AI](https://flowsery.com/pl/features/agents)

# Flowsery CLI

Obsługa Flowsery z terminala lub skryptu. Jeden plik binarny, bez środowiska uruchomieniowego, a każde polecenie może zwracać JSON.

## Instalacja

Do wyboru sposób pasujący do komputera. Homebrew i curl instalują samodzielny plik binarny, więc Node nie jest potrzebny.

npm

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

Homebrew (macOS, Linux)

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

Skrypt instalacyjny (macOS, Linux)

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

Jednorazowe uruchomienie bez instalacji

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

Homebrew 7 odmawia wczytania formuły z zewnętrznego tapa, dopóki nie zostanie on uznany za zaufany, i właśnie to robi brew trust. Bez tego install i upgrade zatrzymają się komunikatem "Refusing to load formula from untrusted tap".

Instalacja udostępnia dwie nazwy tego samego programu. Krótsza to `fsy`.

## Uwierzytelnianie

Należy utworzyć token API i przekazać go do login. Tokeny znajdują się w ustawieniach obszaru roboczego: [API i agenci AI](https://flowsery.com/pl/api-tokens).

```
flowsery login
```

Polecenie otwiera stronę tokenów, odczytuje token z ukrytego pola i sprawdza lokalnie prefiks `flow_ws_` i weryfikuje token jednym wywołaniem API, a potem zapisuje go na dysku z uprawnieniami 0600\. Jeśli weryfikacja się nie powiedzie, nic nie zostanie zapisane.

W CI token można przekazać potokiem, z pominięciem pytania

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

Albo bez zapisywania, przekazując go przy każdym poleceniu

```
FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoami
```

## Szybki start

Tydzień ruchu, najlepsze źródła odesłań z miesiąca, a potem odświeżany widok na żywo.

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

## Polecenia

Każde polecenie przyjmuje --help, a większość --json. Gdy coś nie działa, warto zacząć od flowsery doctor.

Logowanie

| flowsery login  | Zapisuje token API na tym komputerze po sprawdzeniu, że działa |
| --------------- | -------------------------------------------------------------- |
| flowsery logout | Usuwa zapisany token                                           |
| flowsery whoami | Pokazuje używany token i jego zakres dostępu                   |

Codzienna praca

| flowsery site      | Witryny, do których ten token ma dostęp            |
| ------------------ | -------------------------------------------------- |
| flowsery stats     | Ruch, przychody i dane na żywo                     |
| flowsery breakdown | Odwiedzający i przychody według jednego wymiaru    |
| flowsery goal      | Realizacje celów i ich zapisywanie                 |
| flowsery payment   | Zapisywanie przychodów                             |
| flowsery issue     | Problemy w sesjach wykryte przez AI                |
| flowsery visitor   | Jeden odwiedzający: tożsamość, przychód i oś czasu |
| flowsery live      | Odświeżany panel jednej witryny                    |

Narzędzia awaryjne

| flowsery api  | Wysyła uwierzytelnione żądanie do dowolnego endpointu API |
| ------------- | --------------------------------------------------------- |
| flowsery mcp  | Wyświetla konfigurację serwera MCP dla edytora            |
| flowsery open | Otwiera stronę aplikacji webowej w przeglądarce           |

Ten komputer

| flowsery config     | Odczyt i zapis preferencji CLI                                |
| ------------------- | ------------------------------------------------------------- |
| flowsery doctor     | Sprawdza komputer, pliki konfiguracji, API i domyślną witrynę |
| flowsery completion | Wyświetla skrypt uzupełniania dla powłoki                     |

Każde polecenie wyświetla swoje flagi pod `flowsery <command> --help`.

## Skrypty

Po dodaniu --json do dowolnego polecenia wynik ma stałą strukturę z polami ok, command i data, gotową dla jq.

```
flowsery whoami --json
```

Flaga rzadko jest potrzebna. Wynik przełącza się na JSON sam, gdy stdout nie jest terminalem lub ustawiono CI, więc polecenie w potoku od razu zwraca JSON.

Kody wyjścia

| 0 | Sukces                                        |
| - | --------------------------------------------- |
| 2 | Błąd użycia, np. brakująca lub nieznana flaga |
| 3 | Token odrzucony lub brak tokena               |
| 4 | Nic nie pasuje do tego identyfikatora         |
| 5 | API odrzuciło dane wejściowe                  |
| 7 | Zbyt wiele żądań                              |
| 8 | Błąd sieci lub przekroczony czas              |
| 9 | Osiągnięto limit planu lub przydziału         |

## Dalsze kroki

Można utworzyć token albo podłączyć to samo konto do agenta AI.

[Utwórz token API](https://flowsery.com/pl/api-tokens)[Agenci AI i MCP](https://flowsery.com/pl/features/agents)
