抢先体验仅限邀请,SDK 尚未发布。申请邀请
跳到正文
文档

登录

lyrelog login 在浏览器中批准这台电脑。通过 SSH 时,改为粘贴一个代码。会话的有效期与浏览器会话相同。

命令行工具没有密码,也没有自己的密钥。你在已经登录的控制台中批准它,这台电脑就会获得一个会话,和浏览器的会话一样。

lyrelog login

lyrelog login
  1. 浏览器会打开 app.lyrelog.com/cli/authorize。页面会显示这台电脑的名称和它将以哪个账户身份操作,并列出这个工具能做和不能做的事。
  2. 选择 Approve。浏览器会把登录交回这台电脑上的终端,页面显示 You're signed in。你可以关闭这个标签页了。
  3. 终端会显示你以谁的身份登录。如果你只能看到一个项目,它会成为默认项目;如果能看到多个,请运行 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 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

这会在服务器上结束会话,使 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 分钟内登录过控制台。无论哪种方式:

  1. 按用途给它命名(“GitHub Actions, deploy”),并选择过期时间:30 天、90 天(默认)、一年或永不过期。
  2. 复制它:它只显示一次。把它作为 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 也可以,而且它只限于一个项目。