UsageAtlasBeta
Sign inGitHubOpen source
Start here

Add AI coding stats to your GitHub README

Put an AI coding activity heatmap, top models, tools, tokens, or estimated cost in your GitHub README with a free UsageAtlas embed card.

By UsageAtlas on

Quick answer

Publish your UsageAtlas profile, open Account → Embed cards, and copy the Markdown for a card. Paste it into your GitHub README. Cards show an activity heatmap, top models, top tools, total tokens, or estimated cost, in light or dark.

Add a card in four steps

  1. Sign in to the desktop app and save your usage to a free account.
  2. Choose a handle and publish your profile.
  3. Open Account → Embed cards and pick a card, period, theme, and color.
  4. Copy the Markdown and paste it into your README.

The copied Markdown looks like this:

[![AI Coding Token Usage](https://usageatlas.com/api/cards/yourhandle/tokens.svg?period=30d&theme=dark)](https://usageatlas.com/@yourhandle)

Pick a card

  • Heatmap: daily AI coding activity for the last 365 days.
  • Models: your top five models across tools, as a list or pie.
  • Tools: your top five tools, such as Claude Code, Codex, and Cursor.
  • Tokens: total tokens for 7, 30, or 90 days, or all time.
  • Cost: estimated cost in USD for the same periods.

What the card shows

Cards use the usage you saved, never prompts or code. They are plain SVG images with no scripts. If you unpublish the profile, the cards stop rendering within about five minutes.

Questions, answered

Can I show Claude Code stats on my GitHub profile?

Yes. Track Claude Code in UsageAtlas, save to a free account, publish your profile, and paste an embed card into your profile README.

Does the card update by itself?

Yes. It reads your latest saved usage. Images refresh within about 15 minutes.

Is the cost card exact?

No. It shows an estimate from token counts and known model prices, and says so.

Browse by topic