独立安装 CLI
本页介绍如何独立安装 CLI。使用 Client 2 时，可以在桌面应用内安装 CLI 和 Runtime，见开始使用。
CLI 备选方案
CLI 适合终端工作流，也适合暂时无法使用桌面客户端的环境。对于注册表中已提供的版本，选择一种包管理器安装：
npm i -g rsrs-cli或者使用 pnpm：
pnpm add -g rsrs-cli两种命令都会安装 rsrs 启动器，任选一种即可。源码构建见开发。
CLI 平台
下表列出构建产物的目标平台，并非已发布包的清单。安装前请确认所选版本及平台包已提供。
| 平台 | npm 平台包 | Rust target |
|---|---|---|
| Linux x64，musl（默认） | @rsrsai/linux-x64 | x86_64-unknown-linux-musl |
| Linux ARM64，musl（默认） | @rsrsai/linux-arm64 | aarch64-unknown-linux-musl |
| Linux x64，glibc | @rsrsai/linux-x64-gnu | x86_64-unknown-linux-gnu |
| Linux ARM64，glibc | @rsrsai/linux-arm64-gnu | aarch64-unknown-linux-gnu |
| macOS Apple Silicon | @rsrsai/macos-arm64 | aarch64-apple-darwin |
| Windows x64 | @rsrsai/win-x64 | x86_64-pc-windows-msvc |
| Windows ARM64 | @rsrsai/win-arm64 | aarch64-pc-windows-msvc |
Linux 默认使用 musl 包。在兼容的 glibc 主机上须显式选择 glibc；npm 和 pnpm 使用相同的启动器设置：
RSRS_LIBC=glibc rsrs doctor
RSRS_LIBC=musl rsrs doctor
# Keep the selection for subsequent commands in this shell:
export RSRS_LIBC=glibcGNU 包要求兼容的 glibc 主机，不能在 Alpine 上运行。如果安装时省略了可选依赖，请安装与 rsrs-cli 版本相同的目标平台包。Intel Mac 不在产物目标范围内。
初次运行
安装兼容 CLI 后：
rsrs --version
rsrs help
rsrs doctor
rsrs --help| 身份场景 | 命令 |
|---|---|
| 首个云端账户 | 按下方步骤交互注册 |
| 浏览器登录 | rsrs login 或 rsrs login --oauth；完成 dashboard 登录/TOTP 并批准 CLI |
| 终端登录 | rsrs login --interactive；输入密码、按要求输入 TOTP，再输入 super 密码 |
| 新设备 | 使用 rsrs login --help 与同步与密钥中说明的恢复选项 |
| 仅本地使用 | rsrs keygen --json |
仅在没有现有密钥的新配置中使用 keygen；不要为已有记忆库重新生成密钥。请私密保存 JSON 输出中的 summary.super 作为恢复材料。为这个新配置注册云账户时，请在宿主终端执行以下命令，并在提示时输入登录密码。请把 YOUR_NAME 换成你的用户名：
rsrs keygen --json
rsrs --runtime-internal --stop
rsrs --direct register --user YOUR_NAME恢复材料应保存在 Git 和聊天日志之外。服务端无法恢复遗失的客户端解密秘密。不要只为修复登录问题而替换已有密钥。
配置的默认 API 为 https://api.rsrs.rs。本地开发服务使用 --addr http://127.0.0.1:8787。
Respire 使用 ~/.rsrs 和 runtime 端口 15169。启动时保留已选账户及其设置。导入旧账户须使用 rsrs migrate 或 TUI 的 Migrate old version，选择来源并指定新账户名。纯备份目录不作为来源，已有目标会被拒绝，原始数据保持完整。迁移与恢复详情见数据模型。
rsrs inject --targets
rsrs inject --id codex
rsrs remember "A reusable decision for this project" --type decision --title "Project decision"
rsrs recall "project decision" --limit 3
rsrs tree