Skip to content

p-society/contributorLeaderboardBot

contributor-leaderboard-bot

A GitHub App built with Probot that manages a leaderboard of contributors by awarding or deducting points via comments.

Features

  • Listens to all issue and pull request comments in your repository.
  • Awards or deducts points to contributors using special commands in comments.
  • Reacts with a 🚀 (rocket) emoji when points are given, and a 😆 (laugh) emoji when points are deducted.
  • Integrates with an external API at localhost:8000/api/v1/ to update the leaderboard.

Usage

To award or deduct points, comment on an issue or pull request with one of the following formats:

  • @contributorLeaderboardBot Give @username 100 points
  • @contributorLeaderboardBot Deduct @username 50 points

Replace @username with the GitHub username and the number with any integer value for points.

Setup

# Install dependencies
npm install

# Run the bot
npm start

Contributing

If you have suggestions for how contributor-leaderboard-bot could be improved, or want to report a bug, open an issue! We'd love all and any contributions.

For more, check out the Contributing Guide.

License

ISC © 2025 ujsquared

About

a GitHub bot that helps in basically "100 points to Gryffindor!" in issues and PR comments.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published