---
title: "Flowsery CLI"
description: "Instale el CLI de Flowsery, inicie sesión con un token de API y maneje todo Flowsery desde su terminal o un script. Salida JSON y códigos de salida reales."
url: "https://flowsery.com/es/features/cli/docs"
---

[Volver a agentes de IA](https://flowsery.com/es/features/agents)

# 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](https://flowsery.com/es/api-tokens).

```
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 login  | Guardar un token de API en esta máquina, tras comprobar que funciona |
| --------------- | -------------------------------------------------------------------- |
| flowsery logout | Eliminar el token guardado                                           |
| flowsery whoami | Mostrar qué token se está usando y a qué da acceso                   |

Trabajo diario

| flowsery site      | Los sitios sobre los que este token puede informar       |
| ------------------ | -------------------------------------------------------- |
| flowsery stats     | Tráfico, ingresos y cifras en tiempo real                |
| flowsery breakdown | Visitantes e ingresos agrupados por una dimensión        |
| flowsery goal      | Objetivos cumplidos, y las escrituras que los registran  |
| flowsery payment   | Escrituras de ingresos                                   |
| flowsery issue     | Problemas de sesión detectados por IA                    |
| flowsery visitor   | Un visitante, su identidad, sus ingresos y su cronología |
| flowsery live      | Un panel que se refresca para un sitio                   |

Salidas de emergencia

| flowsery api  | Enviar una petición autenticada a cualquier endpoint de la API |
| ------------- | -------------------------------------------------------------- |
| flowsery mcp  | Imprimir la configuración del servidor MCP para su editor      |
| flowsery open | Abrir una página de la aplicación web en su navegador          |

Esta máquina

| flowsery config     | Leer y escribir las preferencias del CLI                                             |
| ------------------- | ------------------------------------------------------------------------------------ |
| flowsery doctor     | Comprobar esta máquina, los archivos de configuración, la API y el sitio por defecto |
| flowsery completion | Imprimir 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                                                      |
| - | ---------------------------------------------------------- |
| 2 | Error de uso, por ejemplo una opción ausente o desconocida |
| 3 | El token fue rechazado o falta                             |
| 4 | Nada coincide con ese identificador                        |
| 5 | La API rechazó los datos                                   |
| 7 | Demasiadas peticiones                                      |
| 8 | Fallo de red o tiempo agotado                              |
| 9 | Límite de plan o de cuota alcanzado                        |

## Siguientes pasos

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

[Crear un token de API](https://flowsery.com/es/api-tokens)[Agentes de IA y MCP](https://flowsery.com/es/features/agents)