About this project

github-watcher uses GitHub Actions to periodically check for newly created pull requests in specified repositories. It compares PR file changes against patterns defined in a YAML configuration file. When matches occur, it sends email notifications to recipient groups configured through repository secrets. The system requires secrets for email credentials (Gmail app password or Resend API key), sender address, and recipient mappings. Email provider is auto-selected based on sender domain: Gmail for @gmail.com/@googlemail.com addresses, otherwise Resend. State files track the last processed PR creation time and alerted PR numbers to avoid duplicates. The workflow runs every 30 minutes, updates state only after successful email delivery, and fetches changed files with up to eight concurrent workers. Only newly created PRs are processed.