replay-cli について
replay-cli は、ブラウザーセッションの記録と Replay の録画管理を行うためのコマンドラインスキルです。記録、アップロード、一覧表示、削除に加え、source map のアップロードにも対応します。
主な機能
- 01Replay Browser で指定 URL を記録
- 02ローカル録画と状態の確認
- 03録画をアップロードして閲覧リンクを取得
- 04選択した録画または全録画を削除
- 05Workspace の source map をアップロード
活用シーン
- 01後で確認するために Web サイトのセッションを記録
- 02録画をアップロードして閲覧リンクを共有
- 03ローカル録画を検索または整理
- 04Workspace の source map をアップロード
MCP 対応
README では Replay MCP Server の設定方法に触れ、`REPLAY_API_KEY` で認証して Claude を `https://dispatch.replay.io/nut/mcp` に接続する例を示しています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ replayio/ skills --skill replay-cliインストール後、Claude Code で/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
CLI のバージョンや Replay Browser の情報など、インストール済みの Replay 依存関係に関する情報を表示します。
replayio list
ローカルにあるすべての録画について、ID、ホスト、日付、長さ、ステータス(アップロード済み/録画済み)を一覧表示します。
--json- 詳細情報を含む全リストを表示します
replayio login
ブラウザーを開いて Replay アカウントにログインします。必要に応じてアカウントを作成します。
replayio logout
Replay アカウントからログアウトします。環境変数に設定された API キーは無効になりません。
replayio record [url]
Replay Browser を起動して、指定された URL の録画を開始します。デフォルトの URL は about:blank です。
- ブラウザーを閉じるまで録画は続きます
- 別途指示がない場合、エージェントはメインの URL のみをアップロードしてください
- ブラウザー/CLI の更新を自動的に確認します
replayio remove [ids...]
1 つ以上の録画を削除します。
- 引数を指定しない場合:録画を選択する対話型メニューを開きます
- ID を指定した場合:指定された録画を削除します
-a、--all- ローカルにあるすべての録画を削除します
replayio update
Replay Browser のみを更新します。CLI の更新は npm/yarn/pnpm/bun で行います。
replayio upload [ids...]
1 つ以上の録画をアップロードします。
- 引数を指定しない場合:録画を選択する対話型メニューを開きます
- 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
特定の録画をアップロードする: 記録後に自動でアップロードされなかった場合は、エージェントが前の手順で取得した録画 ID を使用して、録画を手動でアップロードします。
replayio upload <recording-id>
Replay MCP Server を実行して、記録したアプリケーションをデバッグする Claude に MCP サーバーをインストールするには、次のコマンドを実行します。
claude --mcp-config "{
"mcpServers": {
"replay": {
"type": "http",
"url": "https://dispatch.replay.io/nut/mcp",
"headers": {
"Authorization": "${REPLAY_API_KEY}"
}
}
}
}"