Skip to content

CLI 命令

命令说明
riffpad login [--url wss://…]GitHub 设备授权登录(默认);--username 走密码登录
riffpad logout退出并撤销 relay token
riffpad auth查看当前登录账号(实时校验)
riffpad pair打印 6 位配对码与二维码
riffpad run [claude|codex|kimi] [--name N] [--prompt P] [--cwd D]创建并托管会话,终端保持可见可操作
riffpad attach / detach注入/移除 Claude hooks,捕获你自己启动的会话
riffpad sessions列出会话
riffpad statusdaemon 状态
riffpad setup [--remove]安装/移除 Linux systemd 自启
riffpad kill熔断:停止所有会话 + 撤销所有设备
riffpad update检查并替换为最新版本(SHA256 校验 + 原子替换)
riffpad logs查看 daemon 日志
riffpad version版本号

多语种

CLI 输出默认为英文。如需中文,请显式使用 --lang zh--lang en 可显式指定英文。

环境变量

变量说明
RIFFPAD_RELAY_URLrelay 地址(默认 wss://api.riffpad.ai
RIFFPAD_RELAY_USER / RIFFPAD_RELAY_PASSWORD密码登录凭据
RIFFPAD_URL本地 daemon 地址(默认 http://127.0.0.1:8787
RIFFPAD_DIR数据目录(默认 ~/.config/riffpad