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
- 01Download audio for one simulation
- 02Batch-download audio from a run
- 03Filter simulations that have audio
- 04Retrieve a presigned audio URL
- 05Save recordings as WAV files
Use cases
- 01Review a voice agent simulation recording
- 02Collect audio recordings from a run
- 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-audioAfter installing, type/download-audioin Claude Code to confirm it loaded.
Details
From the project READMEDownload 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