1. Use a profile repo: a repo named exactly <your-username>/<your-username>. Its README shows on your profile page.
2. Add markers in that README where stats should land:

   <!--START_SECTION:readme-stats-->
   <!--END_SECTION:readme-stats-->

3. Add secrets at Settings → Secrets and variables → Actions:
   • GH_TOKEN — Personal access token (classic), scope repo. (create one)
   • WAKATIME_API_KEY — optional, only for WakaTime metrics. (get key)
4. Add .github/workflows/update-stats.yml:

   name: Update README Stats
   on:
     schedule:
       - cron: '0 0 * * *'    # daily at midnight UTC
     workflow_dispatch:
   jobs:
     update:
       runs-on: ubuntu-latest
       permissions:
         contents: write
       steps:
         - uses: actions/checkout@v4
         - uses: thanhhaudev/github-stats@v1
           env:
             GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
             WAKATIME_API_KEY: ${{ secrets.WAKATIME_API_KEY }}
             SHOW_METRICS: "CODING_STREAK"

   ⚠️ For long-term use, fork this repository and run your forked Action, or pin to a specific release/SHA instead of relying on thanhhaudev/github-stats@v1. This avoids unexpected behavior changes when the upstream v1 tag moves.

5. Trigger once: Actions → Update README Stats → Run workflow.

📈 Coding Streak

🔥 Current Streak:        14 days
🏆 Longest Streak:        45 days
📊 Daily Average:         3 hrs 44 mins
💪 Total Coding Time:     1,383 hrs 16 mins
🎯 Coding Consistency:    87.5%
📅 Active Days:           128 days

Every other metric: docs/metrics.md.

Set SHOW_METRICS to a comma-separated list. Output appears in the order you list.

Full env var list (timezone, cache, commit author, progress-bar style, emoji stripping, etc.): docs/configuration.md.

• Configuration reference — every env var, progress-bar styles, ready-made configs.
• Caching — skip API calls for unchanged repos.
• Running every few minutes — cron limits, commit spam, rate budgets.

• Reads commit metadata only (timestamps, line counts). Never reads file contents.
• Counts private-repo commits when the token has repo scope.
• Works on any repo, not just your profile repo. Override the marker name with SECTION_NAME.