gitprops

Give props to people on GitHub. Data lives in git.

What it does

A userscript adds a thumbs-up button next to usernames on GitHub. Click it, pick a score (1-5), optionally say why. Your props are committed as JSON to this repo.

A GitHub Action merges everyone's props into totals. The userscript polls and shows scores next to usernames everywhere.

Setup

You need

• A GitHub App (for OAuth login)
• A server running the App code (Express + Octokit)
• The userscript in Violentmonkey

Quick start

App: https://gitprops-app.fly.dev
Userscript: github-respect.user.js

Set the App server URL to https://gitprops-app.fly.dev in userscript settings, then login.

How data is stored

Each user gets one file in respects/:

{
  "user": "alice",
  "given": {
    "bob": { "score": 5, "reason": "great code reviews", "at": "2026-07-22T12:00:00Z" }
  }
}

Totals are computed hourly (or on push) by .github/workflows/aggregate.yml into aggregate/totals.json:

{
  "total_ledgers": 42,
  "users": {
    "bob": { "score": 127, "respecters": 15 }
  }
}

License

MIT

Badge

Embed your props score in any README:

[![gitprops](https://gitprops-app.fly.dev/badge/YOUR_USERNAME)](https://github.com/grave0x/gitprops)