登录
lyrelog login 在浏览器中批准这台电脑。通过 SSH 时,改为粘贴一个代码。会话的有效期与浏览器会话相同。
命令行工具没有密码,也没有自己的密钥。你在已经登录的控制台中批准它,这台电脑就会获得一个会话,和浏览器的会话一样。
lyrelog login
lyrelog login- 浏览器会打开
app.lyrelog.com/cli/authorize。页面会显示这台电脑的名称和它将以哪个账户身份操作,并列出这个工具能做和不能做的事。 - 选择 Approve。浏览器会把登录交回这台电脑上的终端,页面显示 You're signed in。你可以关闭这个标签页了。
- 终端会显示你以谁的身份登录。如果你只能看到一个项目,它会成为默认项目;如果能看到多个,请运行
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 分钟内没有返回,终端会改为要求你输入代码。
登录使用的是 OAuth 的授权码流程加 PKCE,和 Claude Code 一样。浏览器只能把授权码发回这台电脑上的地址(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,然后把页面上显示的代码复制到终端中。这个代码只能使用一次,有效期 5 分钟, 而且只对发起请求的那个终端有效。不要把它粘贴到其他任何地方,也不要交给任何人:拿到它的人就能以你的身份登录。
设置了 BROWSER=none 时,工具也不会打开浏览器。需要打开浏览器时,如果设置了 $BROWSER,就使用它。
只有人才能登录
lyrelog login 拒绝在编程 agent 中、CI 中或没有可输入的终端时运行。由人在那台电脑的终端里登录一次,agent 再使用这个登录。
参见供 agent 和脚本使用。
会话
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 sessionsID 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, 2027Ends 显示延长有效期的登录何时结束,或者显示 kept, never ends。其他会话在连续 14 天未使用后结束。
访问令牌不在这个列表中:用 lyrelog tokens 查看。
lyrelog account sign-out 10 # the ID from the listlyrelog logout
lyrelog logout这会在服务器上结束会话,使 token 在所有地方失效,并把它从这台电脑的配置中移除。
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 会话 token。优先于已保存的登录。 |
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 分钟内登录过控制台。无论哪种方式:
- 按用途给它命名(“GitHub Actions, deploy”),并选择过期时间:30 天、90 天(默认)、一年或永不过期。
- 复制它:它只显示一次。把它作为
LYRELOG_TOKEN存入 CI 的 secrets,绝不要放进代码仓库。
lyrelog tokens 会列出它们,其他命令见访问令牌。
# GitHub Actions
env:
LYRELOG_TOKEN: ${{ secrets.LYRELOG_TOKEN }}
run: lyrelog errors --since 24h --json访问令牌以你的身份操作,就像 lyrelog login 之后的 CLI 一样,但有两点不同:它不会因为未使用而结束,只会在到期或被你吊销时结束
(在账户页面或用 lyrelog tokens revoke);而且它只在创建后的前 10 分钟内算作近期登录,所以之后就无法创建服务器密钥、只读密钥或管理密钥。
和 CLI 会话一样,它不能删除账户或项目,不能更改登录方式,也不能创建另一个令牌。
永不过期的访问令牌,在你吊销之前,对任何拿到它的人都有效。账户页面会把这类令牌标记为 Never expires,
lyrelog tokens 会显示 ⚠ never。尽量设置过期时间,并吊销不再使用的令牌。
之后你可以在账户页面或用 lyrelog tokens expiry <id> --expires 30d(或 90d、1y、never)更改令牌的过期时间,
从当前时间起算。改得更早随时都可以;改得更晚或改为永不过期,需要最近 10 分钟内的登录。
只是从脚本中读取事件?使用只读密钥(lyr_read_...)调用读取 API 也可以,而且它只限于一个项目。