OpenHearth

Find every GitHub contribution your profile activity feed hides.

OpenHearth is a CLI that audits pull requests, issues, and reviews via the GitHub Search API — then reports what GitHub’s truncated activity sidebar doesn’t show (“51 repositories not shown”).

Built for heavy open-source contributors in the AI era, when monthly PR counts can hit hundreds across dozens of repos.

The problem

GitHub’s profile Contribution activity is not a complete ledger:

• Repos are grouped and truncated (“N repositories not shown”)
• The green graph counts commits, not PRs across repos
• Search shows lists; it doesn’t audit or compare against the feed

OpenHearth gives you the full inventory — grouped by repo, with merged / open / closed counts and export.

Install

npx @felix-ayush/openhearth audit USERNAME --month 2026-07

Or install globally:

npm install -g @felix-ayush/openhearth
openhearth audit USERNAME --month 2026-07

Requires Node.js 20+

Quick start

# Full audit — PRs + issues + reviews
openhearth audit Ayush7614 --month 2026-07

# Ranked report: repos likely hidden from your activity sidebar
openhearth hidden Ayush7614 --month 2026-07

# Check auth + Search API quota
openhearth doctor

# Export for spreadsheets or dashboards
openhearth audit Ayush7614 --month 2026-07 --json report.json
openhearth audit Ayush7614 --month 2026-07 --csv report.csv

Commands

| Command | Description | |---------|-------------| | openhearth audit <user> | Full PR + issue + review audit (default) | | openhearth hidden <user> | Ranked likely-hidden repos vs activity sidebar | | openhearth doctor | Auth + GitHub rate-limit status | | --month YYYY-MM | Audit a calendar month | | --from YYYY-MM-DD | Custom range start | | --to YYYY-MM-DD | Custom range end | | --kind pr\|issue\|review\|all | Filter by contribution type | | --token TOKEN | GitHub PAT (or use GITHUB_TOKEN env) | | --json [file] | Export JSON (stdout if no file) | | --csv [file] | Export CSV | | --quiet | Minimal terminal output | | -V, --version | Print CLI version |

What makes OpenHearth different

• Ranked hidden repos — lower-activity repos past the ~25 sidebar cap, least activity first
• Clear rate-limit errors — tells you to set GITHUB_TOKEN (or when quota resets)
• Doctor — openhearth doctor checks auth and Search/Core API limits
• GitHub Action — monthly/on-demand audits with JSON/CSV artifacts
• Full Search API pagination — fetches all results, not just the first page
• Auto date-splitting — when a month exceeds GitHub’s 1000-result search cap
• Export — JSON and CSV for your own tooling

Authentication (recommended)

Without a token, the unauthenticated Search API is limited (~60 requests/hour).

export GITHUB_TOKEN=ghp_your_token_here
openhearth audit USERNAME --month 2026-07

A classic PAT with public read access is enough. The token is sent only to api.github.com.

If you hit a limit, the CLI prints a fix hint — or run openhearth doctor.

GitHub Action

This repository includes .github/workflows/audit.yml:

• workflow_dispatch — pick username + month
• schedule — 1st of each month (previous calendar month)
• Uploads JSON/CSV artifacts from audit and hidden

Example output

  OpenHearth · contribution audit

  Summary · @Ayush7614 · 2026-07

  Total contributions   494
  Unique repositories   78
  PR merge rate         51%

  ⚠ Hidden by activity feed
  Feed shows ~25 busiest repos; Search API found 78.
  ~53 lower-activity repositories are likely truncated.

  Likely hidden repositories · least activity first
  · small-org/side-project 1
  · another/low-activity 2
  ...

Links

• Website & docs: ayush7614.github.io/OpenHearth
• Source: github.com/Ayush7614/OpenHearth
• Issues: github.com/Ayush7614/OpenHearth/issues

Author

Ayush Kumar — @Ayush7614

License

MIT