Transform your Git commit history into meaningful insights with AI-powered analysis. This CLI tool processes your repository's commits to generate both technical summaries and business-friendly reports, making it easier to track and communicate development progress across your team.
- 🤖 AI-powered commit analysis and categorization
- 📊 Dual reporting: Technical details and business-friendly summaries
- 📅 Flexible date range filtering
- 👥 Author-specific analysis support
- 💾 Smart caching for quick subsequent views
- 🔄 Support for both current and custom repository paths
The tool provides an intuitive CLI interface with the following options:
- Select repository (current directory or custom path)
- Choose date range and optional author filter
- AI processes commits and generates insights
- Caches results for quick future access
- View detailed technical analysis of commits
- See code statistics and changes
- Access AI-generated technical insights
- Perfect for developers and technical leads
- Business-friendly bullet-point summaries
- Focus on user-facing improvements
- Clear explanation of technical changes for non-technical stakeholders
- Ideal for project managers and stakeholders
- Node.js (Latest LTS version recommended)
- Git repository
- Google AI API key (for AI-powered analysis)
- Clone the repository:
git clone [your-repo-url]
cd ai-cli-github-weekly-report-generator
- Install dependencies using pnpm:
npm install
- Create a
.env
file in the root directory and add your Google AI API key:
GOOGLE_API_KEY=your_api_key_here
Start the CLI tool:
npm start
The interactive CLI will guide you through:
- Selecting your repository
- Choosing date ranges for analysis
- Filtering by specific authors (optional)
- Viewing technical or business-friendly reports
- TypeScript
- LangChain with Google AI
- CLI Progress
- Inquirer for interactive CLI
- date-fns for date manipulation
- Zod for schema validation
- Chalk for CLI styling
MIT