命令行工具
在终端中使用 Lyrelog。搜索和实时跟踪事件,查看错误、会话和用户,管理项目、密钥和组织。
lyrelog 就是终端里的控制台。它用 Explorer 的筛选条件搜索事件,实时跟踪事件,并显示错误、会话、用户、版本、Insights 和用量。
它还能管理项目、密钥、组织和你的账户。删除账户或项目,以及更改登录方式(通行密钥、关联账户、两步验证),仍然只能在控制台中进行:
Lyrelog 会拒绝来自 CLI 的这些操作,这样即使 CLI 会话被人复制,也无法把你锁在门外或抹掉你的数据。
它为两类使用者而设计。人看到的是表格和颜色;程序或编程 agent 只会得到 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 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>,命令都会使用这个项目。如果你只能看到一个项目,lyrelog login 会替你选好它。
查看事件
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=422接下来,试试 lyrelog errors:问题按组归并,最严重的排在最前。或者用 lyrelog events -f 实时观察到达的事件。
功能一览
| 查看你的数据 | |
|---|---|
events | 像 Explorer 一样搜索事件;-f 实时跟踪新事件。另有 events get、summary、values、attributes |
errors | 按分类和事件名归组的问题,最严重的排在最前 |
sessions | 会话:谁、多长时间、发生了什么、有哪些错误 |
people | 项目的用户,使用项目自己的称呼 |
person | 单个用户:总数、最近的会话和事件;导出或删除其数据 |
releases | 每个应用版本的健康状况 |
insights | 趋势、比率和漏斗 |
usage | 本月事件数与套餐额度的对比 |
| 配置及其他 | |
|---|---|
projects、use | 列出、查看、修改和创建项目,并选择默认项目 |
keys | 列出、创建和吊销 API 密钥 |
orgs | 组织、组织的成员和邀请 |
account | 你的名字,以及你在哪些地方登录了 |
tokens | 用于 CI 的访问令牌:列出、创建、更改有效期、吊销 |
login、logout、whoami | 登录和退出 |
open | 在控制台中打开对应的页面 |
api | 以登录身份调用任意控制台 API 路由 |
每个命令都有 --help,并附带示例。
输出如何切换
在终端中,lyrelog 用 Lyrelog 的配色绘制表格。以下情况下它会改为输出 JSON:
- 输出被导入管道或文件(
lyrelog errors | jq),或者 - 由编程 agent 或 CI 运行(Claude Code、Cursor、Codex 等,通过它们设置的环境变量识别)。
--json 和 --human 可以强制使用其中一种。在 JSON 模式下,stdout 只输出数据,错误是 stderr 上的一行 JSON,
退出码说明出了什么问题。参见供 agent 和脚本使用。
颜色会适配浅色和深色终端。如果判断有误,请设置 LYRELOG_THEME=dark 或 light。NO_COLOR=1 或 --no-color 可以关闭颜色。