Skip to content
Sarj Repo Standards
sarj/github/job-timeouts

Set job timeouts

Executable GitHub Actions jobs have explicit time bounds.

warning beta

Examples

FlaggedFails
jobs:
  test:
    steps:
      - run: echo ok
PassesClean
jobs:
  test:
    timeout-minutes: 15
    steps:
      - run: echo ok

Why it matters

A hung job can consume runner capacity indefinitely.

How detection works

An executable job omits timeout-minutes; reusable-workflow call jobs are exempt.

What is inspected

  • parsed executable job definitions

Limits

  • requiring timeout-minutes on reusable-workflow call jobs

How to fix it

Bound every executable job with timeout-minutes.

  1. Choose a reviewed upper bound for each executable job.

Verify

  • Run repo-lint again and confirm the rule passes.