Terug naar AI-agents

Flowsery CLI

Bedien Flowsery vanuit je terminal of een script. Eén binary, geen runtime om te beheren, en elk commando kan JSON uitvoeren.

Installeren

Kies wat bij je machine past. Via Homebrew en curl installeer je een losse binary, dus Node is niet nodig.

npm
npm install -g @flowsery/cli
Homebrew (macOS, Linux)
brew trust Flowsery/tap && brew install Flowsery/tap/flowsery
Installatiescript (macOS, Linux)
curl -fsSL https://flowsery.com/install.sh | sh
Eén keer uitvoeren, zonder te installeren
npx -p @flowsery/cli flowsery --help

Homebrew 7 weigert een formula uit een tap van derden te laden totdat je die vertrouwt, en dat is wat brew trust doet. Sla je dit over, dan stoppen zowel install als upgrade met "Refusing to load formula from untrusted tap".

De installatie geeft je twee namen voor hetzelfde programma. De korte is fsy.

Authenticatie

Maak een API-token aan en geef het aan login. Tokens vind je in je werkruimte-instellingen: API & AI-agents.

flowsery login

Het commando opent de tokenpagina, leest het token uit een verborgen prompt en controleert lokaal het voorvoegsel flow_ws_ en verifieert het daarna met één API-aanroep voordat het met modus 0600 naar schijf wordt geschreven. Er wordt niets opgeslagen als de controle mislukt.

In CI: geef het token via een pipe door en sla de prompt over

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

Of sla opslag helemaal over en geef het per commando mee

FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoami

Snelstart

Een week verkeer, de belangrijkste referrers van een maand en daarna een live weergave die zichzelf ververst.

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

Commando's

Elk commando accepteert --help, en de meeste --json. Voer eerst flowsery doctor uit als er iets niet klopt.

Toegang

flowsery loginSla een API-token op deze machine op, nadat is gecontroleerd dat het werkt
flowsery logoutVerwijder het opgeslagen token
flowsery whoamiToon welk token in gebruik is en wat het kan zien

Dagelijks werk

flowsery siteDe websites waarover dit token kan rapporteren
flowsery statsCijfers over verkeer, omzet en realtime
flowsery breakdownBezoekers en omzet gegroepeerd op één dimensie
flowsery goalVoltooide goals, en de schrijfacties die ze registreren
flowsery paymentSchrijfacties voor omzet
flowsery issueDoor AI gevonden sessieproblemen
flowsery visitorEén bezoeker, met identiteit, omzet en tijdlijn
flowsery liveEen dashboard voor één website dat zichzelf ververst

Nooduitgangen

flowsery apiStuur een geauthenticeerd verzoek naar elk API-endpoint
flowsery mcpToon de MCP-serverconfiguratie voor je editor
flowsery openOpen een pagina van de webapp in je browser

Deze machine

flowsery configCLI-voorkeuren lezen en schrijven
flowsery doctorControleer deze machine, de configuratiebestanden, de API en de standaardwebsite
flowsery completionToon het script voor shell-aanvulling

Elk commando toont zijn eigen flags onder flowsery <command> --help.

Scripting

Voeg --json toe aan elk commando en je krijgt een stabiele envelop met ok, command en data, klaar voor jq.

flowsery whoami --json

De flag heb je zelden nodig. De uitvoer schakelt vanzelf naar JSON als stdout geen terminal is of CI is ingesteld, dus een commando in een pipe geeft al JSON.

Exitcodes

0Geslaagd
2Gebruiksfout, zoals een ontbrekende of onbekende flag
3Het token is geweigerd of ontbreekt
4Niets gevonden met die id
5De API weigerde de invoer
7Te veel verzoeken
8Netwerkfout of time-out
9Limiet van abonnement of quotum bereikt

Volgende stappen

Maak een token aan, of koppel hetzelfde account in plaats daarvan aan een AI-agent.