Acesso antecipadoSó por convite, e os SDKs ainda não foram publicados.Pedir um convite
Ir para o conteúdo
Docs

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@latest

Isso 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 login

O 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 7d
Tilefall · 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=422

Depois, 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
eventsBusca eventos como o explorer; -f acompanha os novos. events get, summary, values, attributes
errorsProblemas agrupados por área e nome de evento, os piores primeiro
sessionsSessões: quem, quanto tempo, o que aconteceu, erros
peopleAs pessoas do projeto, com a palavra que ele usa
personUma pessoa: totais, sessões e eventos recentes; exportar ou apagar os dados dela
releasesA saúde de cada versão do app
insightsTendências, taxas e funis
usageOs eventos deste mês em relação ao seu plano
Configurar e mais
projects, useListar, mostrar, alterar e criar projetos, e escolher o padrão
keysListar, criar e revogar chaves de API
orgsOrganizações, as suas pessoas e os convites
accountO seu nome, e onde você entrou
tokensTokens de acesso para CI: listar, criar, mudar a validade, revogar
login, logout, whoamiEntrar e sair
openAbrir a mesma página no painel
apiChamar 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.