mcpField
D
download-audio

download-audio

github.com/coval-aiTesting & quality360 installsUpdated 1d ago
Repository

About download-audio

A skill for downloading audio recordings from Coval simulations with the `coval` CLI. It supports individual downloads, batch downloads from a run, and retrieving a temporary audio URL.

Key features

  1. 01Download audio for one simulation
  2. 02Batch-download audio from a run
  3. 03Filter simulations that have audio
  4. 04Retrieve a presigned audio URL
  5. 05Save recordings as WAV files

Use cases

  1. 01Review a voice agent simulation recording
  2. 02Collect audio recordings from a run
  3. 03Fetch a temporary URL without downloading

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/coval-ai/coval-external-skills --skill download-audio

After installing, type/download-audioin Claude Code to confirm it loaded.

Details

From the project README

Download Simulation Audio

Download audio for $ARGUMENTS.

Single Simulation

coval simulations audio <simulation_id> -o recording.wav

This downloads the audio file with a progress bar.

Bulk Download (All from Run)

Step 1: List Simulations with Audio
coval simulations list --run-id <run_id> --format json | \
  jq -r '.[] | select(.has_audio == true) | .simulation_id'
Step 2: Download Each
for sim_id in $(coval simulations list --run-id <run_id> --format json | jq -r '.[] | select(.has_audio == true) | .simulation_id'); do
  coval simulations audio $sim_id -o "${sim_id}.wav"
done
Step 3: Organize

Suggest organizing by test case:

mkdir -p audio/<run_id>
# Download files into organized directory

Audio URL Only

To get the URL without downloading:

coval simulations audio <simulation_id>

This prints the presigned URL (valid for 1 hour).

Notes

  • Audio is only available for voice agent simulations
  • URLs expire after 1 hour
  • Format is typically WAV or MP3
  • Files include both agent and simulated caller audio

Comments

Markdown supported