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 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 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.
flowsery loginPolecenie 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-stdinAlbo bez zapisywania, przekazując go przy każdym poleceniu
FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoamiSzybki 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 livePolecenia
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 --jsonFlaga 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.