# Watch Run

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

- Skill: `coval-ai/watch-run` (Agent Skill)
- Install (CLI): `npx skillmds@latest add coval-ai/watch-run`
- Raw SKILL.md: https://api.skillmd.com/api/skills/coval-ai/watch-run/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: coval-ai (https://skillmd.com/u/coval-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/coval-ai/watch-run

---


# Watch Coval Run Progress

Monitor the progress of run `$ARGUMENTS`.

## Workflow

### Step 1: Identify Run

If no run ID provided, list recent runs:

```bash
coval runs list --page-size 10
```

Ask user to select a run to watch.

### Step 2: Watch Progress

```bash
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:

```bash
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 |