The leaderboard for your engineering team.
Kreds turns the work your team already does on GitHub into a live leaderboard: merged pull requests, code reviews, closed issues. Not a vanity commit counter. The scoring is weighted so that helping someone else ship beats shipping alone.
kreds.sh · Docs · Self-hosting · Pricing · Sponsor
Note
Kreds Core is open source under AGPLv3. Run it, change it, sell services around it. The Official Kreds Network, which powers the shared KRED economy on kreds.sh, is separate infrastructure. See Open source at the core.
Important
The application UI is in active development. This repository currently holds the marketing site, the licensing and the self-hosting path. Screenshots of the leaderboard, activity feed and profile land with the first app release. Follow Discussions if you want to know when.
Every engineering team has work that is invisible on a contribution graph. The thorough review at 6pm. The flaky test someone finally fixed. The person who unblocks three others before lunch.
Kreds makes that visible. It listens to GitHub events and scores the things that actually move a team forward, through two systems that never touch each other.
Contribution Points are recognition. Cumulative, never spent, no supply.
| Action | Points |
|---|---|
| Merged pull request | 10 to 50 |
| Code review | 10 to 60 |
| Issue resolved | 5 to 20 |
KRED is currency, with a fixed supply and a double-entry ledger.
| Action | KRED | Source |
|---|---|---|
Pull request merged to main / master |
5 to 35 | Issued from the Central Bank reserve |
| Code review | 5 to 40 | Paid by the pull request author, less a 2% fee |
Merging creates KRED. Reviewing moves it. The author pays for help improving their work, which is the whole opinion of the product expressed as an accounting rule. If reviews created currency instead, two accounts could review each other and print unlimited supply.
Self reviews, bot reviews and reviews filed after the merge are worth zero. Full detail in docs/kreds-rules.md.
Standups tell you what people say they did. Dashboards tell you how many lines changed. Neither tells you who is holding the team together.
Kreds is built on one opinion: the highest-leverage engineering work is helping other people ship, and if you are going to measure anything, measure that. Everything else in the product follows from it.
Requires Node 20.11+, pnpm 9, and Docker (for Postgres and Redis).
git clone https://github.com/zitdevs/kreds.git
cd kreds
pnpm install
cp .env.example .env # fill in your GitHub credentials
docker compose up -d db redis
pnpm dev # http://localhost:3000You will need two things from GitHub, and they are different on purpose:
- An OAuth App identifies the person signing in (
read:user,read:org). - A GitHub App, installed once on your org, delivers
pull_request,pull_request_reviewandissueswebhooks. This is where all activity comes from. No member ever grants access to code.
Both are walked through step by step in docs/self-hosting.md.
Self-hosting is a first-class path, not a grudging concession.
cp .env.example .env
docker compose up -d- Runs anywhere Docker runs: your laptop, a VPS, your own Kubernetes.
- Bring your own GitHub App credentials. Your events never leave your infra.
- Postgres + Redis, both in the compose file.
- No license key, no phone-home, no seat check.
Full guide: docs/self-hosting.md
The hosted version at kreds.sh exists so you don't have to run it yourself. Self-hosting is always free.
| Plan | Price | For |
|---|---|---|
| Community | Free | Up to 20 members, 1 team, unlimited repos |
| Team | $2.99 / member / month | Unlimited members, integrations, API, seasons |
| Growing | $79 / month flat | Up to 50 members, cheaper than Team from 27 people |
| Enterprise | Custom | SSO/SAML, SCIM, audit logs, SLA, on-prem |
Free forever for verified open-source projects. If your work is public, so is ours. Open an issue with a link to your org and we'll flip the switch.
Full breakdown: kreds.sh/#pricing
Kreds Core is licensed under AGPLv3. Run it yourself, inspect every part of the system, modify it, and contribute back.
| ✅ | Read, fork and study the source |
| ✅ | Self-host it: laptop, VPS, your own cloud |
| ✅ | Use it commercially, in a company of any size |
| ✅ | Modify it however you like |
| ✅ | Sell services around it, including hosting it |
| ✅ | Contribute changes back |
AGPLv3 has one obligation that ordinary GPL does not: if you modify Kreds and offer that modified version as a service over a network, its users must be offered the source of your modified version. Run it unmodified, or modify it for your own team, and nothing changes for you.
It does not prohibit commercial use, and it does not stop you charging for hosting. The LICENSE is authoritative; docs/licensing.md is the plain-language version.
Kreds Core AGPLv3, open source, runs standalone
Kreds Network Public protocol specification
kreds.sh Official hosted service on the Official Kreds Network
The Official Kreds Network is separate, proprietary infrastructure: the Official KRED ledger and its fixed supply, the Central Bank, global settlement, network identity and the risk systems that keep the shared economy honest. It is not in this repository.
That is not the good parts held back. It is the part that only exists because the economy is shared, and whose anti-abuse rules stop working the moment they are public. Everything that does not require a shared network is open, and a self-hosted Kreds runs a complete economy without ever talking to kreds.sh.
Details: Kreds Core and the Kreds Network.
The code is AGPLv3 with no added conditions. The name is governed separately in TRADEMARKS.md, which is permissive about honest use and strict about presenting a fork as the official service.
Contributions are genuinely welcome. Bug reports, docs fixes, new achievement ideas, integrations.
pnpm install
pnpm dev
pnpm lint && pnpm typecheckStart with CONTRIBUTING.md. Issues labelled
good first issue
are scoped small on purpose. Development happens in the open: roadmap, design
decisions and trade-offs all live in
Discussions.
By contributing you agree your work is licensed under the same terms as the project. See CONTRIBUTING.md.
Kreds is built and maintained by ZitDevs. Sponsorship is what keeps the Community tier free and generous rather than a trial in disguise.
If Kreds helps your team, consider supporting development. Not in a position to? Star the repo, file a bug report with a reproduction, or tell us why Kreds did not work for your team. That helps too.
| Self-hosting guide | Docker, GitHub App setup, upgrades, backups |
| Kreds rules | How scoring works and how to tune it |
| Licensing | What AGPLv3 means for you, in plain terms |
| Contributing | Local setup, conventions, PR flow |
| Core vs Network | What is open, what is not, and why |
| Economic Constitution | The 34 laws the economy runs on |
| Trademarks | Using the Kreds name |
| Security | Reporting a vulnerability |
| Support | Where to ask questions |