Volver a agentes de IA

Flowsery CLI

Maneje Flowsery desde su terminal o un script. Un solo binario, sin runtime que mantener, y cada comando puede imprimir JSON.

Instalación

Elija la que encaje con su máquina. Homebrew y el script de curl instalan un binario independiente, así que no hace falta Node.

npm
npm install -g @flowsery/cli
Homebrew (macOS, Linux)
brew trust Flowsery/tap && brew install Flowsery/tap/flowsery
Script de instalación (macOS, Linux)
curl -fsSL https://flowsery.com/install.sh | sh
Ejecutar una vez, sin instalar
npx -p @flowsery/cli flowsery --help

Homebrew 7 se niega a cargar una fórmula de un tap de terceros hasta que usted lo apruebe, que es lo que hace brew trust. Sin ese paso, install y upgrade se detienen con «Refusing to load formula from untrusted tap».

La instalación deja dos nombres para el mismo programa. El corto es fsy.

Autenticación

Cree un token de API y páselo a login. Los tokens viven en los ajustes de su espacio de trabajo: API y agentes de IA.

flowsery login

El comando abre la página de tokens, lee el token en un campo oculto, comprueba en local el prefijo flow_ws_ y lo verifica con una llamada a la API antes de escribirlo en disco con modo 0600. Si la comprobación falla, no se guarda nada.

En CI, pase el token por una tubería y sáltese el aviso

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

O no guarde nada y páselo en cada comando

FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoami

Inicio rápido

Una semana de tráfico, los principales referentes en un mes, y luego una vista en vivo.

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

Comandos

Todos los comandos aceptan --help, y casi todos aceptan --json. Ejecute flowsery doctor si algo va mal.

Entrar

flowsery loginGuardar un token de API en esta máquina, tras comprobar que funciona
flowsery logoutEliminar el token guardado
flowsery whoamiMostrar qué token se está usando y a qué da acceso

Trabajo diario

flowsery siteLos sitios sobre los que este token puede informar
flowsery statsTráfico, ingresos y cifras en tiempo real
flowsery breakdownVisitantes e ingresos agrupados por una dimensión
flowsery goalObjetivos cumplidos, y las escrituras que los registran
flowsery paymentEscrituras de ingresos
flowsery issueProblemas de sesión detectados por IA
flowsery visitorUn visitante, su identidad, sus ingresos y su cronología
flowsery liveUn panel que se refresca para un sitio

Salidas de emergencia

flowsery apiEnviar una petición autenticada a cualquier endpoint de la API
flowsery mcpImprimir la configuración del servidor MCP para su editor
flowsery openAbrir una página de la aplicación web en su navegador

Esta máquina

flowsery configLeer y escribir las preferencias del CLI
flowsery doctorComprobar esta máquina, los archivos de configuración, la API y el sitio por defecto
flowsery completionImprimir el script de autocompletado del shell

Cada comando lista sus propias opciones bajo flowsery <command> --help.

Scripts

Añada --json a cualquier comando y obtendrá una envoltura estable con ok, command y data, lista para jq.

flowsery whoami --json

Rara vez necesitará la opción. La salida pasa a JSON por su cuenta cuando stdout no es un terminal o CI está definido, así que un comando en una tubería ya devuelve JSON.

Códigos de salida

0Éxito
2Error de uso, por ejemplo una opción ausente o desconocida
3El token fue rechazado o falta
4Nada coincide con ese identificador
5La API rechazó los datos
7Demasiadas peticiones
8Fallo de red o tiempo agotado
9Límite de plan o de cuota alcanzado

Siguientes pasos

Cree un token, o conecte la misma cuenta a un agente de IA.