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

Entrar

lyrelog login aprova este computador no navegador. Por SSH, você cola um código. A sessão dura como a de um navegador.

A ferramenta de linha de comando não tem senha nem chave próprias. Você a aprova pelo painel, onde você já entrou. Isso dá a este computador uma sessão, igual à de um navegador.

lyrelog login

lyrelog login
  1. O seu navegador abre app.lyrelog.com/cli/authorize. A página mostra o nome deste computador e a conta com que ele vai agir, e lista o que a ferramenta pode e não pode fazer.
  2. Escolha Approve. O navegador devolve o login ao terminal deste computador, e a página diz You're signed in. Você pode fechar a aba.
  3. O terminal diz com que conta você entrou. Se você só vê um projeto, ele vira o padrão; se vê mais, rode lyrelog use <project>.
Approve MacBook-Pro in the browser window that opened.
If none did, open:
  https://app.lyrelog.com/cli/authorize?...
On another computer? Press Enter to get a code to paste instead.

Só aprove um login que você mesmo iniciou. Cancel na página deixa a ferramenta desconectada. Se o navegador não voltar em 5 minutos, o terminal pede um código.

O login usa o authorization code do OAuth com PKCE, como o Claude Code. O navegador só pode devolvê-lo para um endereço deste computador (127.0.0.1), e só o terminal que o iniciou pode usá-lo.

Por SSH, ou sem navegador

Num servidor que você acessa por SSH, ou num Linux sem tela, lyrelog login não tenta abrir um navegador. lyrelog login --no-browser também não. Em vez disso, ele mostra o endereço da página:

Open this page, approve server-1, and paste the code it shows:

  https://app.lyrelog.com/cli/authorize?...

Paste the code:

Abra esse endereço em qualquer navegador, escolha Approve e copie para o terminal o código que a página mostra. O código funciona uma vez, pelos próximos 5 minutos, e só para o terminal que o pediu. Nunca o cole em outro lugar nem o passe para ninguém: com ele, a pessoa poderia entrar como você.

A ferramenta também pula o navegador quando BROWSER=none está definido. Quando abre um, ela usa $BROWSER, se estiver definido.

Só uma pessoa pode entrar

lyrelog login se recusa a rodar sob um agente de código, numa CI ou sem um terminal onde digitar. Uma pessoa entra uma vez, num terminal daquele computador, e o agente usa esse login. Veja Para agentes e scripts.

A sessão

Uma sessão da CLI é o mesmo tipo de sessão de um navegador:

  • Ela termina depois de 14 dias sem uso, e depois de 30 dias no máximo, a menos que você a mantenha. lyrelog whoami mostra quando ela termina, no mais tardar. Depois disso, o próximo comando pede que você rode lyrelog login.
  • Criar uma chave de servidor, de leitura ou de administração exige um login recente: nos 10 minutos seguintes à aprovação. Se já passou mais tempo, o comando para com "This needs a recent sign-in" (código de saída 4). Rode lyrelog login de novo e tente outra vez.
  • Uma sessão da CLI não pode aprovar outra. A aprovação sempre acontece no navegador.

A sessão fica salva no arquivo de configurações da ferramenta. A ferramenta nunca a exibe.

Manter um login por mais tempo

No seu próprio computador, talvez você não queira entrar de novo todo mês. Peça para manter o login:

lyrelog login --keep 90d     # or 30d, 1y, never

A página de aprovação mostra a sua escolha e permite mudá-la antes de aprovar: Like a browser (o padrão), 30 days, 90 days, 1 year ou Never expires. Um login mantido dura esse tempo, quer você o use ou não, e só termina antes se você o desconectar. Para manter um, você precisa ter entrado no painel nos últimos 10 minutos; se não entrou, a página pede que você entre primeiro.

Um login que nunca expira funciona para qualquer pessoa que copie o arquivo de configurações deste computador, até você desconectá-lo. Escolha essa opção só num computador de confiança. A página da conta o marca como Never expires, e lyrelog whoami também avisa.

Ver e encerrar as suas sessões

A seção Where you're signed in da página da conta lista os seus navegadores e todos os computadores onde a CLI está conectada, como CLI on seguido do nome do computador. Você pode desconectar qualquer um deles ali. O próximo comando nesse computador vai pedir para rodar lyrelog login de novo.

Pelo terminal:

lyrelog account sessions
ID  Where            Kind          Signed in  Last used  Ends
11  MacBook-Pro      command line  3m ago     15s ago                           this one
 9  Chrome on macOS  browser       4h ago     3m ago
10  build-box        command line  25m ago    25m ago    kept to Feb 17, 2027

Ends mostra quando um login mantido termina, ou kept, never ends. Os outros terminam depois de 14 dias sem uso. Os tokens de acesso não aparecem nesta lista: lyrelog tokens os mostra.

lyrelog account sign-out 10     # the ID from the list

lyrelog logout

lyrelog logout

Isso encerra a sessão no servidor, então o token para de funcionar em todo lugar, e o remove das configurações deste computador.

lyrelog whoami

Com que conta você entrou, em qual servidor, quando a sessão termina, o projeto padrão e as suas organizações. lyrelog status é o mesmo comando.

✓ Signed in as Alex Rivera <alex@example.com>
  Server         app.lyrelog.com
  Session        ends by Dec 19, 22:10 at the latest (14 days unused ends it sooner, unless you kept it)
  Project        Tilefall e8bc11c6e22f
  Organizations  Alex Rivera · owner · Free

Variáveis de ambiente

VariávelO quê
LYRELOG_TOKENUm token de acesso (lyr_tok_..., de lyrelog tokens create ou da página da sua conta) ou um token de sessão da CLI. Tem prioridade sobre o login salvo.
LYRELOG_URLO endereço do painel. Padrão https://app.lyrelog.com. --url tem prioridade sobre ela.

Cada servidor tem o seu próprio login no arquivo de configurações, então lyrelog login --url <address> entra em outro servidor sem afetar o primeiro. O último servidor em que você entrou vira o padrão.

Scripts e CI

Use um token de acesso (lyr_tok_...). Crie um pelo terminal, logo depois de entrar (é preciso ter entrado nos últimos 10 minutos):

lyrelog login
lyrelog tokens create --name "GitHub Actions, deploy"   # --expires 30d, 90d (default), 1y or never

Ou no painel: abra a página da sua conta, Access tokens. Lá também é preciso ter entrado nos últimos 10 minutos. De qualquer forma:

  1. Dê a ele o nome do que vai usá-lo ("GitHub Actions, deploy") e escolha quando expira: 30 dias, 90 dias (o padrão), um ano ou nunca.
  2. Copie-o: ele é mostrado uma única vez. Coloque-o nos secrets da sua CI como LYRELOG_TOKEN, nunca num repositório.

lyrelog tokens lista os tokens, e Tokens de acesso tem os outros comandos.

# GitHub Actions
env:
  LYRELOG_TOKEN: ${{ secrets.LYRELOG_TOKEN }}
run: lyrelog errors --since 24h --json

Um token age como você, assim como a CLI depois de lyrelog login, com duas diferenças: ele não termina por falta de uso, só quando expira ou quando você o revoga (na página da conta ou com lyrelog tokens revoke), e só conta como login recente nos seus primeiros 10 minutos, então depois disso não consegue criar chaves de servidor, de leitura ou de administração. Como uma sessão da CLI, ele não pode apagar a conta nem um projeto, nem mudar a forma como você entra, e não pode criar outro token.

Um token que nunca expira funciona para qualquer pessoa que o obtenha, até você revogá-lo. A página da conta marca esses tokens como Never expires, e lyrelog tokens mostra ⚠ never. Prefira uma validade, e revogue os tokens que você não usa.

Você pode mudar a validade de um token depois, contada a partir de agora, na página da conta ou com lyrelog tokens expiry <id> --expires 30d (ou 90d, 1y, never). Encurtar funciona a qualquer momento; prolongar, ou definir como nunca, exige ter entrado nos últimos 10 minutos.

Só vai ler eventos a partir de um script? A API de leitura com uma chave de leitura (lyr_read_...) também serve, e ela fica restrita a um projeto.