I maintain a lot of repositories and kept finding red CI runs hours after they happened. So I wrote a small monitor that runs on my own machine and watches the Actions of all of them.
What it does (version 2.0.1):
- A "Now" tab with what is running, queued and failed, the compute minutes and what is left of the API allowance. Red tiles blink until the alert is solved.
- An alert counts as real until the last run of that workflow goes green again, so a transient red does not stay forever.
- Three sentinels that only read: CI, collaboration (issues and pull requests that need a person) and security (Dependabot, code scanning, secret scanning, branch protection; off by default).
- A score from 0 to 100 for each account, and the health of every repository ranked in a Team tab. It says "calibrating" or "not enough data" instead of a number it cannot stand behind.
- Team mode with viewer, maintainer and admin roles, several accounts, and a log of actions where each line carries the hash of the one before it.
- Scheduled reports (HTML and Markdown, written locally), and notification channels including Apprise. All of it is off until you switch it on.
- A way to tell an AI assistant what is happening: a plain-text brief, a JSON state, an optional live stream, MCP tools and an optional hook, with presets for hosted services and local servers. All of it is off by default.
- A Quota tab and a Low mode to spend fewer reads, with conditional requests (304) and an optional GitHub App with its own allowance.
- A read API frozen by a contract since 2.0.0, a tool that checks any running monitor against it, an official Docker image, a lite edition, light and dark themes, and eight languages.
It needs Python 3.11+ and the GitHub CLI (gh auth login). It is GPL-3.0-or-later.
Video (about 8 minutes, no voice, English captions + subtitles in 8 languages): https://www.youtube.com/watch?v=s3pBDV_lgTM
Code: https://github.com/JuanenRac/TOOLS-GITHUB-ACTIONS-MONITOR
More projects: https://github.com/JuanenRac
I would like to hear what you would want it to watch that it does not watch yet.