GitHub Repository Activity Monitor - A CLI tool for generating comprehensive activity reports for GitHub repositories with AI-powered summaries.
- 📊 Comprehensive Activity Reports - Track commits, pull requests, issues, and code reviews
- 🤖 AI-Powered Summaries - Generate intelligent summaries using GitHub Models API
- 📈 Author Statistics - Detailed breakdown of contributions by author
- 🌿 Branch Analysis - Activity tracking across all active branches
- 🔍 Flexible Filtering - Filter by date range, user, and more
- 🌍 Multi-language Support - Generate reports in different languages
- ⚡ Fast & Efficient - Parallel processing for quick report generation
- 📝 Markdown Output - Readable reports ready to share
- Go 1.21 or higher
- GitHub CLI (
gh) installed and authenticated - GitHub token with access to GitHub Models (for AI summaries)
go install github.com/hazadus/gh-repomon/cmd/repomon@latestgh extension install hazadus/gh-repomongit clone https://github.com/hazadus/gh-repomon.git
cd gh-repomon
just build
# Binary will be in ./bin/gh-repomonGenerate a report for the last 7 days:
gh-repomon --repo owner/repository --days 7Or if installed as a GitHub CLI extension:
gh repomon --repo owner/repository --days 7Generate a report for a specific date range:
gh-repomon --repo owner/repository --from 2025-09-01 --to 2025-09-30Filter by specific user:
gh-repomon --repo owner/repository --days 7 --user usernameGenerate report in Russian:
gh-repomon --repo owner/repository --days 7 --language russianExclude bot activity:
gh-repomon --repo owner/repository --days 7 --exclude-botsSave report to file:
gh-repomon --repo owner/repository --days 7 > report.md- Installation Guide - Detailed setup instructions
- Usage Guide - Comprehensive flag descriptions and examples
- Examples - Real-world use cases
- Troubleshooting - Common issues and solutions
- Architecture - System design overview
- Contributing - How to contribute
- Prompts Guide - Customizing AI prompts
# Clone the repository
git clone https://github.com/hazadus/gh-repomon.git
cd gh-repomon
# Install dependencies
go mod download
# Install Just (task runner)
# macOS
brew install just
# Linux
curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -s -- --to /usr/local/binjust run # Run the application
just build # Build binary
just test # Run unit tests
just test-all # Run all tests (unit + integration)
just format # Format code
just clean # Clean build artifactsContributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
- Inspired by gh-standup
- Built with GitHub CLI Go library
- Powered by GitHub Models