Show your Claude stats on your GitHub profile

Your GitHub profile shows what you ship. Now it can show how you build with Claude: UsageMeter's widgets put your Claude Code tokens, a GitHub-style grid of your days with Claude, your streak, your trophies and your models on your README, as cards or badges that update themselves. Six of the eight widgets are free, with six themes and every layout option. Nothing is public until you switch it on, and adding one takes a minute.

What can you show?

Sample data

Sample data

Sample data

Sample data

There are eight widgets in all:

Source: the widgets page.

How do I add Claude stats to my GitHub profile?

1. Turn them on. Sign in, open your widgets and switch on the ones you want public. Each one has its own switch.
2. Give it your style. In the widget builder, pick a widget, a theme, a card or a badge, the corners and the size, and watch the result live with your own figures. Save it as your default style if you like.
3. Paste the code. Copy the GitHub snippet into the README.md of your profile repository.

Your profile README is the README.md at the root of a public repository named exactly like your GitHub username; GitHub shows it at the top of your profile as soon as it has content (Managing your profile README).

The code, for light and dark mode

GitHub lets a README show a different picture in light and dark mode with the HTML <picture> element and prefers-color-scheme (GitHub changelog). The builder writes it for you, with the dark and light version of the theme you picked; with the GitHub themes it looks like this, your own link id in place of YOUR-ID:

<a href="https://usagemeter.app">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://usagemeter.app/api/badge/YOUR-ID/heatmap.svg?theme=github-dark">
    <img alt="My days with Claude" src="https://usagemeter.app/api/badge/YOUR-ID/heatmap.svg?theme=github-light" width="420" height="196">
  </picture>
</a>

Prefer plain Markdown, a website, Notion or Obsidian? The builder has a tab for each, plus a shields.io endpoint for a classic badge.

Save a default style and the short links follow it: change the theme once in your account and every README that uses a link without options changes with it.

Make it yours

Every widget comes as a card or as a small shields.io-style badge, in three sizes, with its labels in English, French or German. Free, you also choose:

• the theme: dark, light, auto (it follows each visitor), transparent, GitHub dark or GitHub light;
• the corners, from square to round, and the border, on or off;
• the title row, shown or hidden, and a compact form for a denser profile.

Sample data

Sample data

What Pro adds

UsageMeter Pro unlocks everything else:

• 13 more themes: Claude, Claude ivory, Dracula, Nord, Tokyo Night, Catppuccin, Catppuccin Latte, Gruvbox, Solarized dark and light, One Dark, Rosé Pine and Rosé Pine Dawn;
• your own colours for the accent, the background, the text and the border;
• longer ranges: tokens and models over 30 days, the grid of days over 26 or 52 weeks;
• two more widgets: the all-in-one stats card and the Claude Code cost at API prices;
• no UsageMeter branding on the card, and a load animation that stays still for visitors who ask for reduced motion.

Sample data

Sample data

On a free account, a Pro option falls back to the free look instead of breaking your README: a Pro theme shows as dark or light, and the other Pro options are left out. The Pro widgets show a small "UsageMeter Pro" card instead of your figures.

Is it private?

Widgets are strictly opt-in. Nothing is public until you switch on the widgets you choose, and your live limits and your cost each have their own separate switch, off by default: the limits show when you are using Claude right now, the cost what your month is worth. A widget never shows your email, your Claude accounts, your projects, the names of your PCs or your conversations. To stop, turn a widget off, turn everything off, or ask for a new link: old embeds then show "Widget turned off" instead of your figures once image caches refresh, usually within the hour.

What changed

• 24 September 2026: trophies and all-in-one stats widgets, 19 themes, your own colours, corners, borders, compact form, longer ranges and a saved default style.
• 24 September 2026: first version.