Voltar aos agentes de IA

Flowsery CLI

Comande o Flowsery do seu terminal ou de um script. Um binário só, sem runtime para manter, e cada comando pode imprimir JSON.

Instalação

Escolha a que servir à sua máquina. O Homebrew e o script curl instalam um binário autônomo, então não é preciso Node.

npm
npm install -g @flowsery/cli
Homebrew (macOS, Linux)
brew trust Flowsery/tap && brew install Flowsery/tap/flowsery
Script de instalação (macOS, Linux)
curl -fsSL https://flowsery.com/install.sh | sh
Executar uma vez, sem instalar
npx -p @flowsery/cli flowsery --help

O Homebrew 7 se recusa a carregar uma fórmula de um tap de terceiros enquanto você não a aprovar, que é o que o brew trust faz. Sem esse passo, install e upgrade param com «Refusing to load formula from untrusted tap».

A instalação deixa dois nomes para o mesmo programa. O curto é fsy.

Autenticação

Crie um token de API e passe-o ao login. Os tokens ficam nas configurações do seu espaço de trabalho: API e agentes de IA.

flowsery login

O comando abre a página de tokens, lê o token em um campo oculto, verifica localmente o prefixo flow_ws_ e o confirma com uma chamada à API antes de gravá-lo em disco com modo 0600. Se a verificação falhar, nada é salvo.

Em CI, passe o token por um pipe e pule a pergunta

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

Ou não salve nada e passe-o em cada comando

FLOWSERY_API_TOKEN=flow_ws_your_token flowsery whoami

Comece rápido

Uma semana de tráfego, os principais referenciadores em um mês e depois uma visão ao vivo.

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

Comandos

Todos os comandos aceitam --help, e quase todos aceitam --json. Execute flowsery doctor se algo parecer errado.

Entrar

flowsery loginSalvar um token de API nesta máquina, depois de confirmar que funciona
flowsery logoutRemover o token salvo
flowsery whoamiMostrar qual token está em uso e a que ele dá acesso

Trabalho do dia a dia

flowsery siteOs sites sobre os quais este token pode gerar relatórios
flowsery statsTráfego, receita e números em tempo real
flowsery breakdownVisitantes e receita agrupados por uma dimensão
flowsery goalObjetivos cumpridos, e as escritas que os registram
flowsery paymentEscritas de receita
flowsery issueProblemas de sessão detectados por IA
flowsery visitorUm visitante, sua identidade, sua receita e sua linha do tempo
flowsery liveUm painel que se atualiza para um site

Saídas de emergência

flowsery apiEnviar uma requisição autenticada a qualquer endpoint da API
flowsery mcpImprimir a configuração do servidor MCP para seu editor
flowsery openAbrir uma página do aplicativo web no seu navegador

Esta máquina

flowsery configLer e alterar as preferências do CLI
flowsery doctorVerificar esta máquina, os arquivos de configuração, a API e o site padrão
flowsery completionImprimir o script de conclusão da shell

Cada comando lista suas próprias opções em flowsery <command> --help.

Scripts

Adicione --json a qualquer comando e receba um envelope estável com ok, command e data, pronto para o jq.

flowsery whoami --json

Você raramente precisa da opção. A saída vira JSON sozinha quando o stdout não é um terminal ou quando CI está definido, então um comando em um pipe já retorna JSON.

Códigos de saída

0Sucesso
2Erro de uso, por exemplo uma opção ausente ou desconhecida
3O token foi recusado ou está ausente
4Nada corresponde a esse identificador
5A API recusou os dados
7Requisições demais
8Falha de rede ou tempo esgotado
9Limite do plano ou da cota atingido

Próximos passos

Crie um token ou conecte a mesma conta a um agente de IA.