supsub-authlisted
Install: claude install-skill SupSub-AI/supsub-cli
# supsub-auth Skill
Log in, log out, and check authentication status for the SupSub CLI.
## Prerequisites
- 安装:`curl -fsSL https://raw.githubusercontent.com/SupSub-AI/supsub-cli/master/scripts/install.sh | bash`(native 安装,装到 `~/.local`、支持后台自动更新);或包管理器 `npm i -g @supsub/cli` / `pnpm add -g @supsub/cli`
- 登录凭证保存在 `~/.supsub/config.json`(目录权限 0700,文件权限 0600)。`supsub auth login` 走 OAuth 设备授权,成功后写入 `access_token` / `refresh_token`。**CLI 不支持 API Key 登录**,没有 `--api-key` flag / `SUPSUB_API_KEY` 这一类入口。
- **令牌会自动续期**:`access_token` 约 24 小时到期,CLI 在过期前(或收到 401 时)用 `refresh_token` 自动换新令牌并写回配置文件,全程无感。`refresh_token` 约 14 天有效,只有它也失效时才需要重新 `supsub auth login`。
## Commands
### Log in
```
supsub auth login
```
`supsub auth login` 会自动打开浏览器,走 OAuth 设备授权流程(Device Authorization)完成登录;授权成功后把 `access_token` / `refresh_token` 写入 `~/.supsub/config.json`。这是 CLI 唯一的登录方式(不支持 API Key 登录)。
```bash
# 自动打开浏览器完成授权
supsub auth login
# 无头 / e2e 环境:跳过自动打开浏览器,手动复制终端里的链接去授权
SUPSUB_NO_BROWSER=1 supsub auth login
```
> JSON 模式 (`-o json`) 下,登录成功 stdout 输出 `{"success":true,"data":{"client_id":"supsub-cli","email":"...","name":"..."}}`(`email` / `name` 来自登录后拉取的用户信息;若拉取失败这两个字段缺省,退化为 `{"client_id":"supsub-cli"}`);提示信息走 stderr。
---
### Check status
```
supsub auth status
```
Shows the current logged-in user, the masked credential, and its source。正常 OAuth 登录后 `api_key_source` 为 `config`(凭证来自配置文件里的 `access_token`);`api_key` 字段是脱敏后的访问令牌(CLI 沿用 `sk_live_***` 前缀展示,并非真有 API Key)。
```bash
supsub auth status
supsub