Wróć do agentów AI

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.

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 loginZapisuje token API na tym komputerze po sprawdzeniu, że działa
flowsery logoutUsuwa zapisany token
flowsery whoamiPokazuje używany token i jego zakres dostępu

Codzienna praca

flowsery siteWitryny, do których ten token ma dostęp
flowsery statsRuch, przychody i dane na żywo
flowsery breakdownOdwiedzający i przychody według jednego wymiaru
flowsery goalRealizacje celów i ich zapisywanie
flowsery paymentZapisywanie przychodów
flowsery issueProblemy w sesjach wykryte przez AI
flowsery visitorJeden odwiedzający: tożsamość, przychód i oś czasu
flowsery liveOdświeżany panel jednej witryny

Narzędzia awaryjne

flowsery apiWysyła uwierzytelnione żądanie do dowolnego endpointu API
flowsery mcpWyświetla konfigurację serwera MCP dla edytora
flowsery openOtwiera stronę aplikacji webowej w przeglądarce

Ten komputer

flowsery configOdczyt i zapis preferencji CLI
flowsery doctorSprawdza komputer, pliki konfiguracji, API i domyślną witrynę
flowsery completionWyś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

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

Dalsze kroki

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