Docs › GitHub Actions

GitHub Actions

GitHub disables scheduled workflows after 60 days without commits and never tells you; a cron job can also exit 0 without producing anything. RunVouch watches both: a MISSED alert when no run starts within the cadence, and NO_EVIDENCE when the output file was not written.

Add the action

- uses: runvouch/vouch-action@v1
  with:
    agent: nightly-report
    key: ${{ secrets.RUNVOUCH_KEY }}
    cadence: 24h                 # MISSED if no run starts in 24h + grace
    evidence-file: out/report.html
    run: python report.py --out out/report.html

Store your key as a repository secret named RUNVOUCH_KEY. Fails open: if RunVouch is unreachable the step logs a warning and the job runs unmonitored.

Without the action

- run: pip install runvouch
- run: rv run nightly-report --evidence-file out/report.html -- python report.py
  env: {{ RUNVOUCH_KEY: ${{ secrets.RUNVOUCH_KEY }} }}

What you get

MISSED (schedule stopped), FAILED (non-zero exit), NO_EVIDENCE (green run, no output), plus cost caps if your script reports spend via the Python or Node client. Source: github.com/runvouch/vouch-action.

Need a key? Get a free key · Stuck? contact