replay-cli

replay-cli

描述： 当用户需要有关 Replay CLI 命令的帮助时使用，例如录制、上传、管理录制内容或进行身份验证。示例：“上传我的录制内容”“列出我的回放”“登录 Replay”“移除录制内容”“录制一个会话”。

说明：

你正在帮助用户使用 Replay CLI 工具。以下是完整参考：

安装

使用你喜欢的包管理器全局安装 Replay CLI：

npm i -g replayio
# or
yarn add -g replayio
# or
pnpm i -g replayio
# or
bun i -g replayio

身份验证

前往 https://app.replay.io 设置页面，创建 API 密钥，并将其保存到环境变量 REPLAY_API_KEY 中。

可用命令

命令	参数	选项
info	–	–
list	–	--json
login	–	–
logout	–	–
record	[url]	–
remove	[ids...]	-a、--all
update	–	–
upload	[ids...]	–
upload-source-maps	<paths...>	-g、--group、-x、--extensions、-i、--ignore、--root
help	–	–

向任意命令传入 -h 或 --help 可查看更多信息。

命令详情

replayio info

显示已安装的 Replay 依赖项信息，包括 CLI 版本和 Replay Browser 信息。

replayio list

列出所有本地录制内容及其 ID、主机、日期、时长和状态（已上传/已录制）。

• --json - 输出包含详细信息的完整列表

replayio login

打开浏览器以登录 Replay 账户。如有需要，会创建账户。

replayio logout

退出 Replay 账户。不会使环境变量中的 API 密钥失效。

replayio record [url]

启动 Replay Browser 并开始录制指定 URL。默认 URL 为 about:blank。

• 录制会持续进行，直到关闭浏览器
• 如果没有收到其他提示，Agent 应只上传主 URL
• 自动检查浏览器和 CLI 更新

replayio remove [ids...]

移除一个或多个录制内容。

• 不带参数：打开交互式菜单以选择录制内容
• 带 ID：移除指定的录制内容
• -a、--all - 移除所有本地录制内容

replayio update

仅更新 Replay Browser。CLI 更新通过 npm/yarn/pnpm/bun 完成。

replayio upload [ids...]

上传一个或多个录制内容。

• 不带参数：打开交互式菜单以选择录制内容
• 带 ID：上传指定的录制内容
• 上传后返回用于查看录制内容的 URL

replayio upload-source-maps <paths...>

为 Workspace 上传源映射。

• -g、--group <name> - 分组名称（例如，提交 SHA 或发布版本）
• -x、--extensions <exts> - 要处理的文件扩展名（默认值：".js,.map"）
• -i、--ignore <pattern> - 忽略匹配此模式的文件
• --root <dirname> - 相对路径的基目录

replayio help

显示所有可用命令及其说明。

核心工作流

录制并上传会话：

replayio record https://myapp.com
# After recording, you'll be prompted to upload

上传指定录制内容： 如果录制后未自动上传，Agent 应使用上一步中的录制 ID 手动上传录制内容

replayio upload <recording-id>

运行 Replay MCP 服务以调试录制的应用程序 要在 Claude 中安装 MCP 服务，请运行以下命令：

claude --mcp-config "{
    "mcpServers": {
      "replay": {
        "type": "http",
        "url": "https://dispatch.replay.io/nut/mcp",
        "headers": {
          "Authorization": "${REPLAY_API_KEY}"
        }
      }
    }
  }"