Skip to content

jouet ci explain ​

  • Usage: jouet ci explain [FLAGS] [TARGET]

Say whether each failed job is flaky, infrastructure or real, and rerun the failed jobs

For each failed GitHub Actions job of a PR's latest runs, a run or one job: the verdict, the evidence for it, the failed step and an excerpt of its log. The log is read with fixed patterns for failed tests (cargo, nextest, bats, pytest, vitest, jest, go test), compile and lint errors, and runner or network trouble; history comes from the workflow's recent runs. flaky: it passed on the same commit elsewhere (another attempt, or another job on the same OS), or the same test failed on another branch that passed later. infrastructure: the runner, disk, network, a registry, a rate limit, a service container or the cache. real: a compile or lint error, a test that failed on every attempt on this commit, one that passed on this commit only on other OSes (most likely an OS difference), or one that fails the same way on the default branch, which the evidence says is not the change's fault. Anything else is unknown. A job that failed or was cancelled only because another did is listed as following it. --rerun reruns every failed job, and says which were not a flake or infrastructure; it refuses (exit 4) only while the run is still going. A second failure on the same commit turns a flake real. Exits 0 when nothing failed or every failure is flaky or infrastructure, 1 when one is real or unknown, 3 when the PR, run or job does not exist, 4 when nothing has failed yet in a run still going. What it fetches is cached under the state dir, so explaining the same run again is cheap.

Arguments ​

  • [TARGET] — The PR: a number, URL, OWNER/REPO#N or branch, or an Actions run or job URL. Defaults to the current branch's PR

Flags ​

  • --repo <OWNER/NAME> — The repository for a bare number, branch, --run or --job. Defaults to the git remote
  • --run <ID> — Explain this Actions run instead of a PR
  • --job <ID> — Explain this one Actions job
  • --rerun — Rerun the failed jobs
  • --log-lines <N> — Lines of each failure log to show (default 40; 0 shows the whole failed step)
  • -h --help — Print help
MIT LicenseCopyright © 2026jdx.dev