Skip to content
Open source · AGPLv3

The leaderboard for your engineering team.

Merging a pull request creates KRED. Getting it reviewed costs you some, paid to whoever reviewed it. An economy where helping someone ship is the way to get ahead.

kreds ledger --tail
  • +18.00api#128 mergedminted
  • -12.00paid @mariel for her review
  • +11.76reviewed web#131less 2% fee
  • +34 ptscontribution recorded

Double-entry, always. Every movement is a row you can click through to the pull request.

How it works

Four steps, then it runs itself.

No bot to configure, no standup ritual to add, nothing for your team to remember. Kreds reads what GitHub already knows.

  1. 01

    Sign in with GitHub

    One click. Kreds asks for your handle and which organizations you belong to. It never asks for your code.

  2. 02

    Connect your team and repos

    An admin installs the Kreds GitHub App once and picks which repositories count. Everything else stays invisible.

  3. 03

    Earn Kreds from real contributions

    Merges, reviews, approvals, closed issues and streaks. Awarded automatically as the webhooks arrive.

  4. 04

    Compete on the leaderboard

    Weekly, monthly and all-time. Open it on a Friday and see who actually carried the week.

Features

Built for the way engineers actually work.

Every feature exists to answer one question: who is moving this team forward? Anything that did not help answer it did not get built.

GitHub login

OAuth for identity, a GitHub App for activity. Two grants, deliberately separate, so no member ever hands over code access.

Real-time tracking

Webhooks, not polling. A merge shows up in the feed before you have closed the tab.

Leaderboards

Weekly, monthly and all-time, with rank movement so you can see who is climbing, not just who is ahead.

Achievements

First Merge, Review Machine, Top Reviewer, Weekly #1. Define your own on paid plans.

Streaks and achievements

Consecutive days with scoring activity, and milestones worth recognising. Weekends don't break a streak.

Challenges

Time-boxed team goals. “No pull request waits more than 24 hours” beats nagging in standup.

Team insights

Where reviews pile up, who is carrying them, and which repositories nobody is looking at.

Self-hosting

Docker Compose, your infrastructure, your GitHub credentials. No license key, no phone-home.

API and integrations

REST API, outgoing webhooks and exports. Slack, Discord, Linear and Jira on paid plans.

The boards

Two leaderboards, because they answer different questions.

One asks who is economically liquid. The other asks who is doing the work. They are allowed to disagree, and when they do, that is information rather than a problem.

Economykreds board --net
  • 1mariel-dev+1,240
  • 2tomas-r+980
  • 3shu-codes+612
  • 4ana-builds+318
  • 5lu-park+96
  • 6dan-shipsin debt-204

Net position, not balance. A KRED balance is never negative. dan-ships holds zero and owes 204 K for review he has not funded yet.

Contributionkreds board --points
  • 1dan-ships14,920
  • 2mariel-dev13,480
  • 3tomas-r11,240
  • 4shu-codes9,860
  • 5ana-builds7,410
  • 6lu-park5,120

Points are recognition, never currency. They are not spent, not transferred, and never convert to KRED in either direction.

dan-ships leads contribution and trails the economy. He ships more than anyone and reviews almost nothing, so he owes the people who reviewed him. Specialising is legitimate, and the deficit still has to be funded.

How value moves

Created

Pull request merged to main5 to 35
issued from the Central Bank reserve, scaled by quality score

Circulated

Code review5 to 40
paid by the pull request author, less a 2% protocol fee

Reviews move existing KRED rather than creating it. If they minted, two accounts reviewing each other would print supply forever. No quality bar survives that, because the attacker controls both sides.

Contribution Points

  • Merged pull request10 to 50 pts
  • Code review10 to 60 pts
  • Issue resolved5 to 20 pts

Worth nothing, on purpose

  • Reviewing your own pull request
  • Reviews from bots and AI agents
  • Reviews submitted after the merge
kreds ledger --taillive
  • +18.00mariel-dev merged api#4124m
  • -12.00you paid shu-codes for reviewing web#18822m
  • +11.76tomas-r reviewed infra#881h
  • +34 ptsana-builds reviewed api#4373h
  • +0.00dependabot opened web#1905h
Pricing

Generous where it counts.

Self-hosting is free at any size, always. The hosted plans exist so you don't have to run it, and the Community tier is a real product, not a trial with a countdown.

Community

$0forever

Everything a small team needs to make contribution visible.

Get started
  • Up to 20 members
  • 1 team
  • Unlimited repositories
  • GitHub integration
  • PR merged, review and issue tracking
  • Weekly, monthly and all-time leaderboards
  • Activity feed
  • Kreds and streaks
  • Basic achievements
  • Up to 3 custom achievements
  • 1 active challenge
  • Basic reward configuration
  • 30 days of analytics
Most teams

Team

$2.99per member / month

For teams that want the whole thing, priced per person.

Start free trial

Everything in Community, plus:

  • Unlimited members
  • Unlimited achievements
  • Unlimited challenges
  • Advanced Kreds rules
  • Seasons
  • Full analytics history
  • Slack and Discord integrations
  • Linear and Jira integrations
  • API access
  • Webhooks
  • Exports
  • Multiple squads and groups
  • Better admin controls

Growing

$79per month, flat

Same as Team, flat rate. Cheaper from 27 people up.

Choose Growing

Everything in Team, plus:

  • Up to 50 members
  • Flat pricing, no per-seat math
  • Everything in Team
  • Predictable invoice as you hire

Enterprise

Custom

For 50+ engineers and the paperwork that comes with them.

Talk to us

Everything in Growing, plus:

  • 50+ members
  • SSO and SAML
  • SCIM provisioning
  • Audit logs
  • Advanced permissions
  • Dedicated support and SLA
  • Private cloud or on-premise
  • Security and compliance review

Team is per-seat, Growing is flat. Past 27 members Growing is the cheaper of the two, and we would rather tell you than let you work it out on the invoice.

Free forever for open source

If your project is public and non-commercial, the Team tier is yours at no cost. Permanently, not a discount that expires.

Claim it →
Self-hosting

Run an independent Kreds economy on your own infrastructure.

Self-host Kreds anywhere. Your instance runs its own currency, its own monetary policy, its own treasury and its own rules, with no dependency on kreds.sh and nothing held back to push you onto a hosted plan.

Docker, and that's it

Postgres and Redis are in the compose file. One command up, one command to upgrade.

Your GitHub credentials

Your own OAuth App and GitHub App. Events go from GitHub to your server and stop there.

Anywhere you like

A laptop, a $5 VPS, your own Kubernetes. No license key, no seat check, no phone-home.

Documentation included

The real guide, not a teaser: App setup, upgrades, backups, proxies, and the errors we actually see.

bash
# clone, configure, run
$ git clone https://github.com/zitdevs/kreds.git
$ cd kreds
$ cp .env.example .env
$ docker compose up -d

# http://localhost:3000

An independent self-hosted economy does not automatically participate in the Official Kreds Network. Your currency is yours, and it is not Official KRED. Connecting later is an option through the Kreds Network protocol, never a requirement.

One caveat we would rather say up front: GitHub has to reach your webhook endpoint, so a public HTTPS URL is required. For local development, a tunnel does the job.

Licensing

Open source. Not the version of that word that means nothing.

Kreds Core is AGPLv3. Inspect it, fork it, self-host it, improve it, charge money for it. The Official Kreds Network is separate infrastructure, and that separation is the point rather than a catch.

You can

  • Read, fork and study every part of the system
  • Self-host it, on your laptop or in production
  • Use it commercially, in a company of any size
  • Modify it however you like
  • Sell services around it, including hosting it
  • Contribute changes back

The one obligation

If you modify Kreds and offer that modified version as a service over a network, its users must be offered the source of your version. Run it unmodified, or modify it for your own team, and nothing changes for you.

AGPLv3 does not prohibit commercial use, and it does not stop you charging for hosting. Anyone who told you otherwise confused it with a non-commercial licence.

Kreds CoreAGPLv3

Everything in the repository. GitHub integration, teams, contributions, leaderboards, a local economy with its own currency and ledger, self-hosting. A complete product on its own.

Kreds Network ProtocolPublic spec

The boundary between the two. How an instance registers, signs events and talks to the Network. It describes how to communicate, not how the Network decides.

Official Kreds NetworkPrivate

The shared global economy: Official KRED and its fixed supply, the Central Bank, global settlement, network identity, the risk systems. Separate infrastructure, not in the repository.

The Network 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. A self-hosted Kreds runs a complete economy without ever talking to kreds.sh.

Community

Open source, and run like it.

Issues, roadmap and the reasoning behind decisions are all public, contributions are licensed the same as the project with no CLA, and open-source teams get the paid tier for free.

Contributions welcome

Bug reports, docs fixes, new achievement ideas, integrations. No CLA, we only ask that what you send is yours to send.

Read the contributing guide →

Start somewhere small

Issues labelled good first issue are scoped small on purpose, with the context you need already written down.

Browse good first issues →

Built in the open

Roadmap, design decisions and the trade-offs behind them all live in Discussions. Disagree in public. That is the point.

Join the discussion →

Docs, not a teaser

Self-hosting, scoring rules and licensing are documented properly, including the parts that are annoying.

Read the docs →
FAQ

The questions people actually ask.

Including the awkward ones. If something here is still unclear, open a discussion and we will answer it in public.

Is Kreds open source?

Yes. Kreds Core is licensed under AGPLv3, which is an OSI-approved open source license. Not source-available, not open-core with the interesting parts removed. The repository is the whole product.

Can I use Kreds commercially?

Yes. AGPLv3 permits commercial use, and your company can self-host it at any size without asking anyone. You can also charge money for services around it, including hosting it for other people.

Can I modify Kreds and offer it as a service?

Yes, subject to AGPLv3. The one obligation the license adds is this: if people interact with your modified version over a network, they have to be offered the corresponding source of that modified version. Run it unmodified and nothing changes. Modify it for your own team and nothing changes either, because your team is not a third party being served over a network.

Is the Official Kreds Network open source?

No. 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. A shared economy needs one authoritative ledger, and anti-abuse rules stop working when they are published. Everything that does not require a shared network is open.

Does self-hosted Kreds need kreds.sh?

No. A self-hosted instance is independent by default. It runs its own economy, its own currency, its own supply, its own treasury and its own monetary policy, with no dependency on kreds.sh and no automatic participation in the Official Network.

Can a self-hosted instance join the Network later?

That is what the Kreds Network protocol is for. Joining can bring Official KRED, network identity, official settlement and participation in the global economy, and it requires meeting the Network's integrity requirements. Joining preserves history rather than resetting balances.

Can I self-host Kreds?

Yes, free, at any team size, forever. Docker Compose with Postgres and Redis is in the repository, and the whole product is in the box. Nothing is held back to push you onto a paid plan. You bring your own GitHub App credentials, so your events never leave your infrastructure.

Can I use it inside my company?

Yes. Internal use is expressly granted, including in production and at any headcount, and including running it for several teams inside the same organization. Running it for a client as part of consulting work you do for them is fine too.

Can I create a hosted competitor with it?

No. That is the single thing the license forbids. You cannot offer Kreds to third parties on a hosted or embedded basis in order to compete with our paid version, and you cannot sell managed Kreds hosting without a commercial agreement. If that is what you want to build, email us; the conversation is welcome rather than a trap.

Is Kreds free for open-source projects?

Yes. If your project is public and non-commercial, the hosted Team tier is free permanently, not a discount that expires. Open an issue with a link to your organization and we will enable it.

What integrations are planned?

Slack and Discord first, so a weekly recap lands where your team already talks. Linear and Jira after that, so issue work counts alongside GitHub activity. Both are on the paid tiers. The roadmap lives in GitHub Discussions and it moves based on what people actually ask for.

Does Kreds read our source code?

No. The GitHub App asks for read access to metadata, pull requests and issues, never file contents. It receives pull_request, pull_request_review and issues webhooks, which carry titles, authors and states. That is everything Kreds needs to score.

Will a redelivered webhook award Kreds twice?

No. Every award is keyed on the event type, the GitHub node id and the recipient, with a unique index behind it, so a replayed delivery collides and is dropped. GitHub redelivers more often than people expect, so this was built in from the first commit rather than patched in after someone noticed a doubled score.

What happens if an admin changes the Kreds values?

Past awards keep the amount they were granted with. Rule changes only affect future awards, so a leaderboard never silently rewrites itself when someone edits a setting. Each award in the ledger shows the value it was granted with.