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