Watch Mode

Save the file, see the result.

Watch mode runs your requests, then runs them again every time a watched YAML file changes. Edits are debounced, the screen is cleared between runs, and a failing run never stops the watcher.

Read the docs Install curl-runner

health.yaml

# Same as: curl-runner health.yaml --watch
global:
  watch:
    enabled: true
    debounce: 300
    clear: true

requests:
  - name: Health check
    url: http://localhost:3000/health
    expect:
      status: 200

A tight loop
Change a header, a body or an assertion and the run starts again on its own. No switching windows.
Debounced
A burst of saves becomes one run. A change during a run queues exactly one more.
Flag or file
Start it with --watch for a session, or set global.watch in the file so the suite always watches.

Good for

Building a new endpoint against a local server
Writing assertions for an unfamiliar API
Debugging a request until it passes
Keeping a health check on screen while you work