About GitBored
How GitBored finds open source projects, tracks star growth, and suggests related repositories.
Repository discovery & submissions
GitBored indexes open source repositories from several automated feeds and community submissions:
- Scheduled star sweeps: Workers periodically query GitHub star ranges (50k+, 10k–50k, and 100–10k across rotating languages).
- Trending scans: Daily sweeps monitor active GitHub trending repositories.
- Direct submissions: Anyone can submit a repository via the submit page or by replacing
github.comwithgitbored.comin any repository URL. - Renames & redirects: When a repository is renamed or moved on GitHub, scans follow the redirect and migrate history to the canonical name.
Submissions and updates run in the background. A busy queue can delay when new data appears.
Classification & qualification thresholds
Repositories are grouped by star count and recent commit activity:
- 50,000+ stars: always qualified regardless of commit date
- 10,000 to 50,000 stars: active commit within the last year
- 100 to 10,000 stars: active commit within the last 6 months
Active repositories that do not meet the qualified thresholds, plus projects that went quiet. Rechecked weekly and promoted when they qualify.
Repositories under 100 stars with no push in over 6 months are excluded from scheduled scan queues.
Star snapshots & growth tracking
Unlike static star counts, GitBored tracks star velocity over time to help highlight projects gaining momentum:
- Daily snapshots: Starting at 03:00 UTC, workers record stars, forks, watchers, and open issues for qualified, non-archived repositories.
- 35-day window: Growth rates are computed over a rolling 35-day history window and stored on the project for fast sorting.
Gradual availability
Growth numbers require accumulated history and are not available immediately upon indexing:
- Daily growth: requires at least 2 distinct daily snapshots.
- Weekly growth: requires at least 80% coverage (~6 days of snapshot history).
- Monthly growth: requires at least 80% coverage (~24 days of snapshot history).
New repositories display "–" for growth periods that haven't collected enough snapshots yet.
Related repositories & AI embeddings
Related projects use AI-generated summaries to compare what repositories do, rather than matching keywords alone:
- Unified text profile: A structured summary is compiled from the repository name, description, language, topics, activity recency, codebase size, license, and key README sections (overview, usage, features).
- AI comparison: Cloudflare Workers AI converts each summary into an embedding for similarity searches. Unchanged summaries do not need to be regenerated.
- Balanced similarity ranking: Related repositories are ranked using 70% vector cosine similarity plus 30% star-tier proximity.
The star-tier weighting favors projects with similar popularity, alongside similarity in purpose.
Update schedules & freshness
Background maintenance runs on scheduled UTC intervals:
You can verify real-time queue depths, worker status, and recent scan counts on the system health page.
Keyboard shortcuts & navigation
Navigate GitBored quickly from any page using keyboard shortcuts:
- K
- Focus repository search
- S
- Open repository submission form
- L
- Jump to a random qualified project
GitBored is built by Boring Dystopia Development. Repository data is sourced directly via the official GitHub REST API.