Ferramenta de linha de comando
O Lyrelog no seu terminal. Busque e acompanhe eventos, leia erros, sessões e pessoas, gerencie projetos, chaves e organizações.
lyrelog é o painel num terminal. Ele busca eventos com os filtros do explorer, acompanha-os ao
vivo e mostra erros, sessões, pessoas, versões, insights e uso. Também gerencia projetos, chaves,
organizações e a sua conta. Apagar a sua conta ou um projeto, e mudar a forma como você entra
(passkeys, contas vinculadas, verificação em duas etapas), continua sendo feito no painel: o
Lyrelog recusa essas ações vindas da CLI, para que uma sessão de CLI copiada não consiga trancar
você para fora nem apagar os seus dados.
A ferramenta foi feita para dois tipos de usuário. Uma pessoa recebe tabelas e cores. Um programa ou um agente de código recebe JSON e mais nada. A ferramenta percebe qual dos dois a está executando (veja Como a saída muda).
Ainda não publicada
Assim como os SDKs, a ferramenta de linha de comando não é publicada durante o acesso
antecipado. Até lá, o go install abaixo falha: o repositório é privado e ainda não tem
nenhuma release.
Instalação
Você precisa do Go 1.26 ou mais recente:
go install go.lyrelog.com/cli/cmd/lyrelog@latestIsso coloca lyrelog em $(go env GOPATH)/bin, então confira se essa pasta está no seu PATH.
Ainda não há binários pré-compilados publicados; o Homebrew
(brew install GonzaloFuentes28/tap/lyrelog) chega com a primeira release.
Primeiros passos
Entrar
lyrelog loginO seu navegador abre o painel. Aprove este computador, e o terminal recebe o login. Por SSH há outro jeito; veja Entrar.
Escolher um projeto
lyrelog projects
lyrelog use tilefall # its slug, its name or its id Project Slug Events People Errors Last event 24 hours
● Tilefall tilefall 7,291 205 187 7m ago ▂▄▃▅▃▄▅▆▆▇██▆▃▁▂▁▁▁▁▂▃▅▂Os comandos usam este projeto, a menos que você passe -p <project>. Se você só vê um projeto,
lyrelog login o escolhe para você.
Ver os eventos
lyrelog events --level error --since 7dTilefall · production · last 7 days
10:30:07 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422
10:27:43 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422
10:24:48 ▌error cloud_save_failed sync reason=schema_mismatch record=progress status=422Depois, experimente lyrelog errors para ver os problemas agrupados, os piores primeiro. Ou
lyrelog events -f para ver os eventos conforme chegam.
O que ela faz
| Ver os seus dados | |
|---|---|
events | Busca eventos como o explorer; -f acompanha os novos. events get, summary, values, attributes |
errors | Problemas agrupados por área e nome de evento, os piores primeiro |
sessions | Sessões: quem, quanto tempo, o que aconteceu, erros |
people | As pessoas do projeto, com a palavra que ele usa |
person | Uma pessoa: totais, sessões e eventos recentes; exportar ou apagar os dados dela |
releases | A saúde de cada versão do app |
insights | Tendências, taxas e funis |
usage | Os eventos deste mês em relação ao seu plano |
| Configurar e mais | |
|---|---|
projects, use | Listar, mostrar, alterar e criar projetos, e escolher o padrão |
keys | Listar, criar e revogar chaves de API |
orgs | Organizações, as suas pessoas e os convites |
account | O seu nome, e onde você entrou |
tokens | Tokens de acesso para CI: listar, criar, mudar a validade, revogar |
login, logout, whoami | Entrar e sair |
open | Abrir a mesma página no painel |
api | Chamar qualquer rota da API do painel, já autenticado |
Todo comando tem --help, com exemplos.
Como a saída muda
Num terminal, lyrelog desenha tabelas com as cores do Lyrelog. Em vez disso, ele escreve JSON
quando:
- a saída vai para um pipe ou um arquivo (
lyrelog errors | jq), ou - um agente de código ou uma CI o executa (Claude Code, Cursor, Codex e outros, detectados pelas variáveis de ambiente que eles definem).
--json e --human forçam um ou outro. No modo JSON, o stdout traz só os dados, os erros são
uma linha JSON no stderr e o código de saída diz o que deu errado. Veja
Para agentes e scripts.
As cores se adaptam a terminais claros e escuros. Defina LYRELOG_THEME=dark ou light se o
palpite estiver errado. NO_COLOR=1 ou --no-color as desliga.