Git Stargazer automatically tracks and reports activity in your starred GitHub repositories, helping you stay updated through daily reports and a JSON Feed.
- 📊 Daily activity reports for your starred repositories
- 📝 Reports in JSON and Markdown formats with commit summaries
- 📡 JSON Feed for easy monitoring
- 🤖 Bot activity filtering
- 🎯 Configurable repository limits and time windows
- ⚡ Durable watermarks and conditional requests for efficient GitHub API usage
-
Fork this repository
-
Set up required secrets:
- Go to Settings > Secrets and variables > Actions
- Add
RELEASE_TOKEN: A GitHub Personal Access Token withreposcope - Add
DEEPSEEK_API_KEY: (Optional) For model-backed commit summaries
-
Configure variables (optional):
- Go to Settings > Secrets and variables > Actions > Variables
REPO_LIMIT: Maximum repositories to fetch (default: 100)EMPTY_REPO_CONSECUTIVE_LIMIT: Stop after this many consecutive empty reposSUMMARIZER_MODEL: Model used for summaries; leave unset to disable summaries
Reports are automatically generated:
- Daily at 6:30 AM UTC+8 (22:30 UTC previous day)
- On-demand via manual workflow trigger
- Latest report: the "latest" release — its body is the current day's report, with
recent_commits_latest.md,recent_commits_latest.json, andfeed.jsonas assets - JSON Feed: subscribe to
https://github.com/<owner>/git-stargazer/releases/download/latest/feed.json - GitHub Pages: View reports on your fork's GitHub Pages
The release holds only the current renderings; history lives in your feed reader (see docs/adr/0002).
- Markdown Report: Human-readable activity summary grouped by repository topics
- JSON Report: Structured data for programmatic use
- JSON Feed: Subscribe to updates in your favorite feed reader
Contributions are welcome! Please feel free to submit a Pull Request.
This project is open source and available under the MIT License.