アーリーアクセス招待制です。SDK はまだ公開されていません。招待をリクエスト
本文へスキップ
ドキュメント

サインイン

lyrelog login は、ブラウザーでこのコンピューターを承認します。SSH 越しの場合は、代わりにコードを貼り付けます。セッションの有効期間はブラウザーと同じです。

コマンドラインツールには、専用のパスワードもキーもありません。すでにサインインしているダッシュボードから承認します。これで、このコンピューターにブラウザーと同じようなセッションが与えられます。

lyrelog login

lyrelog login
  1. ブラウザーで app.lyrelog.com/cli/authorize が開きます。ページには、このコンピューターの名前と、ツールがどのアカウントとして動くかが表示され、ツールにできることとできないことが一覧されます。
  2. Approve を選びます。ブラウザーがこのコンピューターのターミナルにサインインを返し、ページに You're signed in と表示されます。タブは閉じて構いません。
  3. ターミナルに、誰としてサインインしたかが表示されます。見られるプロジェクトが 1 つだけならそれがデフォルトになります。複数ある場合は 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.

承認するのは、自分で始めたサインインだけにしてください。ページで Cancel を選ぶと、ツールはサインインしないままになります。5 分以内にブラウザーから応答がなければ、ターミナルは代わりにコードを求めます。

サインインには、Claude Code と同じく OAuth の認可コードフローと PKCE を使います。ブラウザーはこのコンピューター上のアドレス(127.0.0.1)にしか認可コードを返せず、それを使えるのはサインインを始めたターミナルだけです。

SSH 越しやブラウザーがない場合

SSH で接続しているサーバーや、ディスプレイのない Linux では、lyrelog login はブラウザーを開こうとしません。lyrelog login --no-browser も同様です。代わりに、ページのアドレスを表示します。

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

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

Paste the code:

そのアドレスを任意のブラウザーで開き、Approve を選んで、ページに表示されたコードをターミナルに貼り付けます。コードは 1 回だけ、5 分以内に、それを求めたターミナルでだけ使えます。ほかの場所に貼り付けたり、誰かに渡したりしないでください。コードがあれば、その人があなたとしてサインインできてしまいます。

BROWSER=none が設定されている場合も、ツールはブラウザーを開きません。ブラウザーを開くときは、$BROWSER が設定されていればそれを使います。

サインインできるのは人間だけです

lyrelog login は、コーディングエージェントや CI から実行された場合と、入力できるターミナルがない場合は、実行を拒否します。人間がそのコンピューターのターミナルで一度サインインし、エージェントはそのサインインを使います。エージェントとスクリプト向けを参照してください。

セッション

CLI のセッションは、ブラウザーのセッションと同じ種類のものです。

  • 14 日間使わないと終了し、最長でも 30 日で終了します。ただしサインインを長く維持する場合は別です。lyrelog whoami で、遅くともいつ終了するかがわかります。終了後は、次のコマンドで lyrelog login を実行するよう求められます。
  • サーバーキー、読み取りキー、管理キーを作るには、最近のサインイン、つまり承認から 10 分以内であることが必要です。それより時間が経っていると、コマンドは「This needs a recent sign-in」で止まります(終了コード 4)。もう一度 lyrelog login を実行してから、やり直してください。
  • CLI のセッションから別のセッションを承認することはできません。承認は常にブラウザーで行います。

セッションはツールの設定ファイルに保存されます。ツールがそれを表示することはありません。

サインインを長く維持する

自分のコンピューターでは、毎月サインインし直したくないかもしれません。その場合は、サインインを維持するよう指定します。

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

承認ページには選んだ期間が表示され、承認する前に変更できます。Like a browser(デフォルト)、30 days、90 days、1 year、Never expires から選びます。維持されたサインインは、使っても使わなくてもその期間続き、それより早く終わるのはサインアウトした場合だけです。サインインを維持するには、過去 10 分以内にダッシュボードにサインインしている必要があります。していなければ、ページがまずサインインを求めます。

有効期限のないサインインは、このコンピューターの設定ファイルをコピーした誰にでも使えてしまいます。サインアウトするまでずっとです。信頼できるコンピューターでだけ選んでください。アカウントページではそのサインインに Never expires と表示され、lyrelog whoami もその旨を表示します。

セッションを確認して終了する

アカウントページの Where you're signed in には、ブラウザーと、CLI がサインインしているすべてのコンピューターが、CLI on とコンピューター名で一覧されます。そこでどれでもサインアウトできます。サインアウトされた側では、次のコマンドで再び lyrelog login を実行するよう求められます。

ターミナルからは次のようにします。

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 には、維持されたサインインが終わる日時、または kept, never ends が表示されます。それ以外は 14 日間使わないと終了します。アクセストークンはこの一覧には含まれません。lyrelog tokens で確認してください。

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

lyrelog logout

lyrelog logout

サーバー上のセッションを終了するのでトークンはどこでも使えなくなり、このコンピューターの設定からも削除されます。

lyrelog whoami

誰として、どのサーバーにサインインしているか、セッションがいつ終わるか、デフォルトのプロジェクト、所属する組織を表示します。lyrelog status も同じコマンドです。

✓ 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

環境変数

変数内容
LYRELOG_TOKENアクセストークン(lyr_tok_...、lyrelog tokens create またはアカウントページで作成)か、CLI のセッショントークン。保存されたサインインより優先されます。
LYRELOG_URLダッシュボードのアドレス。デフォルトは https://app.lyrelog.com。--url のほうが優先されます。

設定ファイルにはサーバーごとにサインインが保存されるので、lyrelog login --url <address> で別のサーバーにサインインしても、最初のサーバーには影響しません。最後にサインインしたサーバーがデフォルトになります。

スクリプトと CI

アクセストークン(lyr_tok_...)を使います。サインインした直後に、ターミナルから作成できます(過去 10 分以内のサインインが必要です)。

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

ダッシュボードで作ることもできます。アカウントページの Access tokens を開きます。こちらも過去 10 分以内にサインインしている必要があります。どちらの場合も、次のようにします。

  1. 使う側に合わせた名前(「GitHub Actions, deploy」)を付け、有効期限を選びます。30 日、90 日(デフォルト)、1 年、または無期限です。
  2. トークンをコピーします。表示されるのは一度だけです。CI のシークレットに LYRELOG_TOKEN として入れ、リポジトリには決して入れないでください。

lyrelog tokens で一覧を表示できます。ほかのコマンドはアクセストークンにあります。

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

トークンは lyrelog login 後の CLI と同じくあなたとして動きますが、違いが 2 つあります。使わなくても終了せず、終わるのは期限切れになるか失効させたとき(アカウントページか lyrelog tokens revoke で)だけです。また、最近のサインインとして扱われるのは最初の 10 分間だけなので、それを過ぎるとサーバーキー、読み取りキー、管理キーは作れません。CLI のセッションと同じく、アカウントやプロジェクトの削除、サインイン方法の変更はできず、別のトークンを作ることもできません。

有効期限のないトークンは、失効させるまで、手に入れた誰にでも使えてしまいます。アカウントページではそうしたトークンに Never expires と表示され、lyrelog tokens には ⚠ never と表示されます。有効期限を付けることをおすすめします。使っていないトークンは失効させてください。

トークンの有効期限は、あとから変更できます(今から数えた期間で指定します)。アカウントページか lyrelog tokens expiry <id> --expires 30d(または 90d、1y、never)で変更します。短くするのはいつでもできますが、長くしたり無期限にしたりするには、過去 10 分以内のサインインが必要です。

スクリプトからイベントを読むだけですか?それなら読み取りキー(lyr_read_...)で読み取り API を使う方法もあり、こちらは 1 つのプロジェクトに限定されます。