REPOMATIC-SAMPLE-METRICS(1) REPOMATIC-SAMPLE-METRICS(1)

repomatic sample-metrics - Record what forges say about the repositories this project tracks

repomatic sample-metrics [OPTIONS]

Record what forges say about the repositories this project tracks.

Reads every subject through whichever API its host speaks (GitHub, GitLab or Forgejo) and appends one row per subject, metric and date. A counter like the star count accrues, so its curve can be charted; an attribute like the date of the newest commit keeps a single row, restamped only when it moves.

GitHub restricted its stargazer endpoints to a repository's own admins in 2026, which left every third-party star chart on the web rendering an error card. It reopened an anonymous star history later that year, and this reads it on a schedule and commits the result: a history that accrues locally cannot be revoked.

Each reading records where it came from, since the curves are not all measured the same way. A GitHub repository has its whole curve rebuilt from that star history, which counts the stars it still holds; every other forge is sampled forward, one reading per run.

CSV store to accumulate into. Defaults to [tool.repomatic.metrics] store.
Restore the store from this remote branch before sampling, so readings still pending in an open pull request are appended to instead of dropped. Name the branch the job publishes to. Ignored when the branch does not exist, which is every run that follows a merge.
Read every subject's current metrics from its own forge.
Rebuild each GitHub subject's star curve from its star history.
Redraw the configured charts from the stored history.
Show this message and exit.

CSV store to accumulate into. Defaults to [tool.repomatic.metrics] store.
Restore the store from this remote branch before sampling, so readings still pending in an open pull request are appended to instead of dropped. Name the branch the job publishes to. Ignored when the branch does not exist, which is every run that follows a merge.
Read every subject's current metrics from its own forge.
Rebuild each GitHub subject's star curve from its star history.
Redraw the configured charts from the stored history.
Show this message and exit.

0
Success.
1
A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2
A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

Record today's readings

repomatic sample\-metrics

Take today's readings without rebuilding the star curves

repomatic sample\-metrics \-\-no\-reconstruct

Kevin Deldycke

2026-09-14 7.15.1.dev0