All Contributors Bot | | WarmIndex

All Contributors is an open-source initiative providing a specification, CLI tool, GitHub App, and documentation site to standardize and automate the recognition of diverse contributions (code, docs, design, mentoring, etc.) in project README files using emoji-based tables.

🚀 Overview

All Contributors addresses the challenge of recognizing all types of contributions in open-source projects, where traditional tools like git shortlog only credit code pushes, ignoring vital non-code work like documentation, design, bug triaging, and community management.

It's built for open-source maintainers, project leads, and collaborative teams who want to foster an inclusive culture by automatically crediting everyone who helps the project succeed.

The project was created to promote fair recognition, making it effortless to maintain an up-to-date contributor table so maintainers can focus on building rather than admin work.

✨ Key Features

Comprehensive specification defining 35+ contribution types with unique emojis for standardized README tables.
CLI tool (all-contributors-cli) for local automation of adding/updating contributors in GitHub or GitLab repos.
GitHub App (bot) that responds to commands like @all-contributors add username docs by creating PRs with updated tables.
Rich documentation site with guides, emoji key, and usage instructions. Optional: Experimental ML platform for contributor insights (ac-learn repo).

🛠 Tech Stack

Frontend: MDX, JavaScript (docs site)
Backend: Node.js, JavaScript/TypeScript (CLI and App)
Database: N/A
Auth: GitHub OAuth / Probot framework for the App
Hosting: GitHub Pages/repos, custom domain for site

👥 Who Is This For?

This project is useful for:

Developers who want to easily credit all OSS contributors beyond code
Teams looking for automated, inclusive acknowledgment in READMEs
Indie makers building community-driven projects

📸 Screenshots / Demo

Live demo: https://allcontributors.org (features example contributor table and docs)
GitHub: https://github.com/all-contributors (organization), https://github.com/all-contributors/allcontributors.org (8k+ stars), https://github.com/all-contributors/app, https://github.com/all-contributors/cli

🔥 Project Status

🟢 Actively building

Last updated: 2026-03-24

❓ FAQ

Is this project free?

Yes / Open Source (Free to use for any project; MIT licensed.)

Is the source code available?

Yes — https://github.com/all-contributors/allcontributors.org, https://github.com/all-contributors/app, https://github.com/all-contributors/cli, https://github.com/all-contributors/all-contributors

Can I contribute?

Yes — follow the all-contributors specification ironically! Open issues or PRs on relevant repos, provide feedback via GitHub Discussions, or use the bot/CLI. All contribution types welcome (code, docs, ideas, etc.).