locmeter
v0.2.0
Published
Render a PNG chart of lines changed over time from your GitHub contribution repos.
Downloads
630
Readme
locmeter
locmeter is a dependency-free Node CLI that scans your locally cloned GitHub contribution repos, aggregates added and deleted lines by day, week, or month, and renders a PNG chart.
Repository: jojopirker/locmeter
npx locmeter

Requirements
- Node.js 18+
ghCLI authenticated- network access for
gh api - local clones of the repos you want included
git
Usage
locmeterOr without installing globally:
npx locmeterInstall
npm install -g locmeterCommon options:
- default bucket:
week - default mode:
sum - default
--to: today - default
--from: one year before--to - default author identity: auto-detected from your current
ghlogin - default repo root: current directory, then common roots like
~/Developer,~/Code,~/Projects - default search depth:
3 --from YYYY-MM-DD--to YYYY-MM-DD--days N--bucket day|week|month--mode sum|added|deleted|added/deleted|added/deleted/sum--root /path/to/repos--search-depth N--author-email [email protected]--author-name yourname--output chart.png--json-output data.json
Modes:
sumaddeddeletedadded/deletedadded/deleted/sum
Example:
locmeter \
--root ~/Developer \
--bucket week \
--mode added/deleted/sum \
--output examples/jojo-weekly-added-deleted-sum.png \
--json-output examples/jojo-weekly-added-deleted-sum.jsonThe CLI prints the generated PNG path and JSON path on success.
Notes
locmeteris intended for global CLI usage.- JSON output includes separate
added,deleted, andsumseries.
