This command collects metrics for a GitHub repository and generates reports in multiple formats.
Caution
As of 10 February 2026, this project is archived and no longer being actively maintained.
Run this command in the root directory of a GitHub repository:
~/workspace/wpcs-action
% npx github:10up/metrics-generator --help
Usage
$ metrics-generator
Options:
--pat Personal access token.
--repo Full repository name. Ex: 10up/ads-txt.
--from Start date. Accepts Date.parse() compatible formats.
--to End date. Accepts Date.parse() compatible formats.
--wpSlug The plugin handle on wordpress.org.
--outputDir Directory for output files.
--html Enable HTML output. Boolean. Enabled by default.
--json Enable JSON output. Boolean. Disabled by default.
--md Enable Markdown output. Boolean. Disabled by default.
--help Show help.% npx github:10up/metrics-generator --repo=10up/ads-txt --from='01 Feb 2022' --to='28 Feb 2022' --pat=<github_personal_access_token> --wpSlug=ads-txt --md --json
% ls
ads-txt.html ads-txt.json ads-txt.md
% cat ads-txt.json
{
"repo": "ads-txt",
"owner": "10up",
"watchers": 48,
"stars": 40,
"forks": 22,
"releases": 0,
"orgDownloads": 509284,
"orgActiveInstalls": 100000,
"orgAverageRatings": 4.5,
"openIssues": 0,
"closedIssues": 2,
"openPullRequests": 4,
"closedPullRequests": 1,
"mergedPullRequests": 4,
"internalContributors": 3,
"externalContributors": 1,
"internalCommits": 35,
"externalCommits": 2
}| Metric | 01 Feb 2022 - 28 Feb 2022 |
|---|---|
| Repo | ads-txt |
| Owner | 10up |
| Watchers | 48 |
| Stars | 40 |
| Forks | 22 |
| Releases | 0 |
| Org Downloads | 509284 |
| Org Active Installs | 100000 |
| Org Average Ratings | 4.5 |
| Open Issues | 0 |
| Closed Issues | 2 |
| Open Pull Requests | 4 |
| Closed Pull Requests | 1 |
| Merged Pull Requests | 4 |
| Internal Contributors | 3 |
| External Contributors | 1 |
| Internal Commits | 35 |
| External Commits | 2 |
- Due to the limitation of the WordPress.org API, the downloaded count is the latest count, regardless of time range.
- This only works with GitHub repositories.
- For WordPress metrics, this command only supports plugins for now.
- Due to the rate limit of unauthorized API access, we may need PAT to ensure GitHub doesn't block our requests. Personal Access Token can be created here,
read:orgscope is required to query concealed contributors.
Archived: This project is no longer maintained by 10up. We are no longer responding to Issues or Pull Requests unless they relate to security concerns. We encourage interested developers to fork this project and make it their own!
A complete listing of all notable changes to Metrics Generator are documented in CHANGELOG.md.
Please read CODE_OF_CONDUCT.md for details on our code of conduct, CONTRIBUTING.md for details on the process for submitting pull requests to us, and CREDITS.md for a list of maintainers, contributors, and libraries used in this repository.
