Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

A CLI tool for generating comprehensive activity reports for GitHub repositories with AI-powered summaries.

License

Notifications You must be signed in to change notification settings

hazadus/gh-repomon

Repository files navigation

gh-repomon

CI Status License: MIT

GitHub Repository Activity Monitor - A CLI tool for generating comprehensive activity reports for GitHub repositories with AI-powered summaries.

✨ Key Features

  • 📊 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

🚀 Requirements

  • Go 1.21 or higher
  • GitHub CLI (gh) installed and authenticated
  • GitHub token with access to GitHub Models (for AI summaries)

📦 Installation

Via Go Install

go install github.com/hazadus/gh-repomon/cmd/repomon@latest

As GitHub CLI Extension

gh extension install hazadus/gh-repomon

From Source

git clone https://github.com/hazadus/gh-repomon.git
cd gh-repomon
just build
# Binary will be in ./bin/gh-repomon

🎯 Quick Start

Generate a report for the last 7 days:

gh-repomon --repo owner/repository --days 7

Or if installed as a GitHub CLI extension:

gh repomon --repo owner/repository --days 7

Generate a report for a specific date range:

gh-repomon --repo owner/repository --from 2025-09-01 --to 2025-09-30

Filter by specific user:

gh-repomon --repo owner/repository --days 7 --user username

Generate report in Russian:

gh-repomon --repo owner/repository --days 7 --language russian

Exclude bot activity:

gh-repomon --repo owner/repository --days 7 --exclude-bots

Save report to file:

gh-repomon --repo owner/repository --days 7 > report.md

📚 Documentation

🛠️ Development

Setup Development Environment

# 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/bin

Available Commands

just 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 artifacts

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

�� License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📧 Support

About

A CLI tool for generating comprehensive activity reports for GitHub repositories with AI-powered summaries.

Topics

Resources

License

Contributing

Stars

Watchers

Forks