github-actions-annotations-reporterStop ignoring your green-run annotations.

Turn workflow notices, warnings, and errors into tracked GitHub Issues — deduplicated, severity-labeled, history-aware, and auto-closed when the noise stops.

Get started

CLI reference

Stable fingerprinting

`sha256(workflowPath + annotationPath + normalizedMessage)` — line numbers are deliberately excluded so a benign refactor never spawns a duplicate issue.

Severity-aware

Every annotation files an issue tagged with `severity/notice|warning|error`. Filter with `--min-severity` or escalate via config.

History-aware suppression

Closed prior issues can suppress future filings via any of three signals: a configured label (default `wontfix`), `state_reason: not_planned`, or a regex on the closing comment.

Auto-close, safely

When an annotation stops appearing, the matching issue is auto-closed — but only after a configurable miss-counter + age grace period, and (by default) only when the source workflow's latest run actually succeeded.

Idempotent state in-body

Persisted last-seen, miss counter, and first-seen timestamps live in HTML comments inside the issue body. No external datastore.

Tested above 90%

190+ unit tests, strict TypeScript, hardened composite-action bash dispatcher. CI runs on Node 22 across Linux, macOS, and Windows.

Install

bash

# global
npm install -g github-actions-annotations-reporter

# or with pnpm
pnpm add -g github-actions-annotations-reporter

# or ephemeral
npx github-actions-annotations-reporter

30-second demo

bash

# Dry-run: see what would change, don't write anything
ghaar scan --dry-run

# Apply: create / update / reopen / auto-close issues as needed
ghaar report

# List currently-managed issues
ghaar list

Use as a GitHub Action

yaml

- uses: ylabonte/github-actions-annotations-reporter@v1
  with:
    min-severity: warning
    auto-close-after-days: 7
    auto-close-after-misses: 3

See the use-as-action guide for the full input/output reference.