wtf is pr-reminder-bot?

This project is a small bot that watches your GitHub repositories for pull requests that have been sitting open without a review for too long, and then posts a reminder message to Slack listing them. The default cutoff is 24 hours, but you can set your own threshold. Setup involves getting a GitHub token with read-only access to pull requests on the repos you want to watch, and creating a Slack app with an incoming webhook so the bot has somewhere to post. The README offers a guided setup script that walks you through entering these values and writing them into a configuration file, or you can do each step manually. There is also a manual command to run the check once and confirm it works before scheduling it. Because this is meant to run on a recurring schedule rather than by hand, the README covers a few ways to automate it: a systemd timer on Linux that runs it every hour, a simple cron job on macOS or Linux, or deploying it as a scheduled GitHub Action or Cloudflare Worker if you would rather not manage a machine yourself. To avoid spamming the same channel repeatedly about the same pull request, the bot keeps a small local file that tracks which pull requests it has already flagged and at what age. It only sends a new notification once a pull request crosses into the next threshold multiple, so a 24 hour threshold means a PR gets flagged at 24 hours, then again at 48 hours if still unreviewed, and so on. This lets you run the check as frequently as you like without getting repeated alerts for the same PR. The README includes a clear security note that the configuration file holds real secrets, a GitHub token and a Slack webhook URL, and warns not to commit that file or share it in chat tools, and to revoke and regenerate both if they are ever exposed. This tool would suit any team using GitHub and Slack together who wants pull requests to stop going unnoticed.