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

コマンドラインツール

ターミナルから使う Lyrelog。イベントの検索と追跡、エラー、セッション、ユーザーの確認、プロジェクト、キー、組織の管理ができます。

lyrelog は、ターミナルで使うダッシュボードです。エクスプローラーと同じフィルターでイベントを検索し、ライブで追いかけ、エラー、セッション、ユーザー、リリース、インサイト、使用量を表示します。プロジェクト、キー、組織、アカウントの管理もできます。アカウントやプロジェクトの削除と、サインイン方法の変更(パスキー、連携アカウント、2 段階認証)はダッシュボードでしか行えません。Lyrelog は CLI からのこれらの操作を拒否するので、CLI のセッションがコピーされても、締め出されたりデータを消されたりすることはありません。

想定している使い手は 2 種類です。人間にはテーブルと色付きの表示を、プログラムやコーディングエージェントには JSON だけを返します。どちらが実行しているかはツールが自分で判断します(出力の切り替わり方を参照)。

まだ公開されていません

SDK と同じく、コマンドラインツールもアーリーアクセスの間は公開されていません。公開されるまでは、下の go install は失敗します。リポジトリが非公開で、まだリリースもないためです。

インストール

Go 1.26 以降が必要です。

go install go.lyrelog.com/cli/cmd/lyrelog@latest

これで lyrelog が $(go env GOPATH)/bin に入るので、そのフォルダーが PATH に含まれていることを確認してください。ビルド済みのバイナリはまだ公開していません。Homebrew(brew install GonzaloFuentes28/tap/lyrelog)は最初のリリースで提供します。

はじめの一歩

サインインする

lyrelog login

ブラウザーでダッシュボードが開きます。このコンピューターを承認すると、ターミナルがサインインを受け取ります。SSH 越しの場合は別の方法があります。サインインを参照してください。

プロジェクトを選ぶ

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      ▂▄▃▅▃▄▅▆▆▇██▆▃▁▂▁▁▁▁▂▃▅▂

-p <project> を渡さない限り、コマンドはこのプロジェクトを使います。見られるプロジェクトが 1 つだけなら、lyrelog login が自動で選びます。

イベントを見る

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

次は lyrelog errors を試してみてください。問題がグループ化され、深刻なものから表示されます。届いたイベントをその場で見るには lyrelog events -f を使います。

できること

データを見る
eventsエクスプローラーと同じようにイベントを検索します。-f で新しいイベントを追いかけます。events get、summary、values、attributes
errors領域とイベント名でグループ化した問題を、深刻なものから表示します
sessionsセッション:誰が、どれくらいの時間、何が起きたか、エラー
peopleプロジェクトのユーザー(プロジェクト独自の呼び名で表示)
person1 人のユーザー:合計、最近のセッションとイベント。データのエクスポートや削除
releasesアプリの各バージョンの健全性
insightsトレンド、割合、ファネル
usage今月のイベント数とプランの比較
設定など
projects, useプロジェクトの一覧、表示、変更、作成と、デフォルトのプロジェクトの選択
keysAPI キーの一覧、作成、失効
orgs組織、そのメンバーと招待
account名前と、サインインしている場所
tokensCI 用のアクセストークン:一覧、作成、有効期限の変更、失効
login, logout, whoamiサインインとサインアウト
openダッシュボードで同じページを開きます
apiサインインした状態で、ダッシュボードの任意の API ルートを呼び出します

どのコマンドにも、例付きの --help があります。

出力の切り替わり方

ターミナルでは、lyrelog は Lyrelog の配色でテーブルを描きます。次の場合は代わりに JSON を出力します。

  • 出力がパイプやファイルに渡されるとき(lyrelog errors | jq)
  • コーディングエージェントや CI が実行するとき(Claude Code、Cursor、Codex など。それらが設定する環境変数で判定します)

--json と --human でどちらかに固定できます。JSON モードでは、stdout にはデータだけが出力され、エラーは stderr に 1 行の JSON として出力され、終了コードで何が起きたかがわかります。エージェントとスクリプト向けを参照してください。

色はライトとダークのターミナルに合わせて変わります。判定が違う場合は LYRELOG_THEME=dark または light を設定してください。NO_COLOR=1 または --no-color で色をオフにできます。