Repolode
Submit
anmol098

anmol098/waka-readme-stats

A GitHub Action that generates WakaTime coding statistics and renders them as text or SVG charts inside your GitHub profile README.

View on GitHub
Stars
4,003
Forks
651
Open issues
72
Last commit
5 days ago

What is it?

waka-readme-stats is a GitHub Action that pulls coding activity from WakaTime and writes it into a section of your profile README on a schedule. It can show total coding time, languages, editors, operating systems, projects, timezone, and commit activity by time of day and weekday.

The action works by looking for a pair of marker comments in your README.md and replacing the content between them on each run. Each block can be turned on or off with feature flags, and the output can be localized, shown as Unicode text bars or colorful SVG bars, and styled with several badge styles. It can also list languages per repository and lines of code written, and it can use a self-hosted WakaTime-compatible backend such as Wakapi.

Recent versions add a weekly AI coding breakdown that covers AI versus hand-written lines, token usage, estimated cost and per-model usage, when that data is available in the WakaTime account.

Key features

  • 01Updates a marked section of your profile README automatically on a cron schedule.
  • 02Shows coding time, languages, editors, OS, projects, and timezone from WakaTime.
  • 03Breaks down commits by time of day and day of week, with optional lines-of-code stats.
  • 04Supports Unicode text bars or SVG bars with configurable colors and corner radius.
  • 05Localizes output and can point to a self-hosted Wakapi instance.

Use cases

  • Showing your coding habits and language mix on your GitHub profile page.
  • Tracking personal coding time over the year in a README without manual updates.
  • Running a self-hosted WakaTime-compatible server while still displaying stats on GitHub.

Quick start

  1. 1

    Add the start and end section comments to your profile README.md

  2. 2

    Save WAKATIME_API_KEY and GH_TOKEN as repository secrets

  3. 3

    Add the workflow file that uses anmol098/waka-readme-stats@master and commit it

  4. 4

    Run the workflow from the Actions tab (workflow_dispatch) to see the result

Things to know

  • Requires a WakaTime API key and a GitHub token with the repo scope, which is broad access.
  • The lines of code flag is disabled by default because it is a heavy operation.
  • AI coding stats only appear if your WakaTime account has AI coding tracking data.

Topics

#github-action#wakatime#profile-readme#coding-stats#readme#svg#automation#awesome#profile#profile-page

FAQ

What is waka-readme-stats?
A GitHub Action that generates WakaTime coding statistics and renders them as text or SVG charts inside your GitHub profile README. waka-readme-stats is a GitHub Action that pulls coding activity from WakaTime and writes it into a section of your profile README on a schedule. It can show total coding time, languages, editors, operating systems, projects, timezone, and commit activity by time of day and weekday.
Is waka-readme-stats free to use? What license does it have?
waka-readme-stats is open source under the MIT license. Check the license terms before using it in commercial products.
Is waka-readme-stats still maintained?
Actively maintained. The last commit to waka-readme-stats was on Nov 2, 2026.
What can I use waka-readme-stats for?
Showing your coding habits and language mix on your GitHub profile page. Tracking personal coding time over the year in a README without manual updates. Running a self-hosted WakaTime-compatible server while still displaying stats on GitHub.
How do I install waka-readme-stats?
Add the start and end section comments to your profile README.md Save WAKATIME_API_KEY and GH_TOKEN as repository secrets Add the workflow file that uses anmol098/waka-readme-stats@master and commit it Run the workflow from the Actions tab (workflow_dispatch) to see the result
Where can I get waka-readme-stats?
The source code and installation instructions are on GitHub: https://github.com/anmol098/waka-readme-stats

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

badges / shields

Shields.io is a service and NPM library that generates concise SVG and raster status badges for README files and web pages.

DevOps & Cloud#badge#svg#status-badge
27.4K+23 this week5.6KJavaScriptApache-2.0Well maintainedUpdated yesterday