This project uses CrewAI to analyze weekly and monthly GitHub activity for the Nexus-Rcoe organization.
All data is fetched directly from the GitHub REST API (HTTP-based) to ensure accuracy and reliability.
No assumptions or hallucinated data are used.
The primary objective is to provide clear visibility into:
- Who is contributing and how much
- Which members are inactive
- Which repositories are active, moderate, or stagnant
- A clean, management-ready weekly report
The crew runs in a sequential workflow, where each step builds on the previous one.
- Fetches all repositories under the Nexus-Rcoe organization
- Uses direct GitHub REST API calls
- Collects only verified repository metadata
Collected information:
- Repository name
- Repository URL
- Description
- Visibility
- Analyzes commit history for each repository
- Calculates contribution metrics for:
- Commits in the last 7 days
- Commits in the last 30 days
- Ranks contributors per repository
- Identifies organization members who made no contributions
Output includes:
- Per-repository contributor rankings
- Commit counts per contributor (weekly and monthly)
- List of non-contributing members
- Evaluates repository-level activity trends
- Uses commit frequency and contributor distribution to assess momentum
Project activity categories:
- Active – consistent commits and contributor participation
- Moderate – occasional activity
- Low / Stagnant – little to no recent activity
- Combines contribution analysis and project evaluation
- Produces a clean, professional, management-friendly report
Final report includes:
- Top contributor for each repository
- Overall top 3 contributors across the organization
- Members with no contributions
- Project activity status summary
-
GitHub Context Collector
Collects repository data using GitHub HTTP APIs only -
Contribution Analyzer
Processes commit data and computes contribution metrics -
Project Progress Evaluator
Assesses repository health and activity trends -
Report Generator
Converts analytical results into a structured weekly report
- Uses only GitHub REST API responses
- No inferred, estimated, or hallucinated data
- Fully reproducible and auditable analysis
- Weekly engineering activity reviews
- Team performance visibility
- Identifying inactive contributors
- Tracking project health across repositories
MODEL=gpt-4.1-mini-2025-04-14
OPENAI_API_KEY=your_openai_api_key_here
GITHUB_TOKEN=your_github_personal_access_token_here
CREWAI_TRACING_ENABLED=true
DISCORD_WEBHOOK_URL=your_discord_webhook_url_here
DISCORD_COMMAND_CHANNEL_ID=your_discord_channel_id_here
DISCORD_BOT_TOKEN=your_discord_bot_token_here