Show your Token Forest on your GitHub README
A live badge of your tree — species, growth stage, total tokens, and worldwide rank — that you can paste into your GitHub profile README. It updates itself as your forest grows.
What it is
The badge is a small image served from a URL, so it always shows your current stats — you never edit your README to keep it fresh. It reads only what is already public on the leaderboard for players who have opted in, and reveals nothing new.
How to get yours
- Open Token Forest and turn the leaderboard On (it is off by default). Your badge only exists once you have opted in.
- In the app menu, choose “Copy my leaderboard badge” — it copies a one-line Markdown snippet with your own ID.
- Paste it into your GitHub profile README (the README in the repo named after your username).
The snippet looks like this — the app fills in your ID for you:
[](https://tokenforest.com.au/en/leaderboard)
Privacy
The badge shows only your display name, tree species, token total, and rank — the same fields already visible on the public leaderboard, and only if you opted in. It never exposes your code, prompts, or any per-time-of-day breakdown. If you leave the leaderboard, the badge falls back to a generic Token Forest image.
Grow a forest worth showing off
Token Forest turns the Claude Code and Codex tokens you spend into a living pixel tree, with a global leaderboard behind it. Free, Windows and macOS.