Watch Run

Monitor a Coval run's progress with live updates. Use when user wants to check run status or wait for completion.

coval-ai 4be5934 1.2 KB Updated

File contents

Watch Coval Run Progress

Monitor the progress of run $ARGUMENTS.

Workflow

Step 1: Identify Run

If no run ID provided, list recent runs:

coval runs list --page-size 10

Ask user to select a run to watch.

Step 2: Watch Progress

coval runs watch <run_id> --interval 2

This displays a live progress bar showing:

  • Completed / Total test cases
  • Current status (PENDING, IN QUEUE, IN PROGRESS, COMPLETED, FAILED)
  • Percentage complete

Step 3: Report Results

When the run completes, summarize:

coval runs get <run_id> --format json

Report:

  • Total simulations completed
  • Pass/fail counts (if available)
  • Duration
  • Link to results

Options

Flag Description Default
--interval Refresh rate in seconds 2

Statuses

Status Meaning
PENDING Run created, not yet queued
IN QUEUE Waiting for capacity
IN PROGRESS Simulations running
COMPLETED All simulations finished
FAILED Run encountered an error
CANCELLED User cancelled the run

coval-ai/coval-external-skills/tree/main/skills/runs/watch-run commit 4be5934092

Frequently asked questions

npx skillmds@latest add coval-ai/watch-run