A fully automated GitHub repository analyzer that counts lines of code across all your repositories and updates stats dynamically. Runs on the default branch of each repo and skips forks.
[ LANGUAGES BREAKDOWN ]
JavaScript --> 142,483 lines
TypeScript --> 111,308 lines
JSX --> 20,312 lines
Vue.js --> 0 lines
PHP --> 5,248 lines
C# --> 0 lines
Other --> 8,158 lines
[ TOTAL LINES OF CODE: 287,509 ]
Stats update automatically via GitHub Actions.
This GitHub Action automatically fetches all your public repositories (excluding forks), clones the default branch, and analyzes lines of code using cloc. It then updates the repository’s README.md with the latest code statistics. The workflow runs by default every Sunday at midnight UTC (customizable), keeping your stats up to date.
-
Add the Workflow File
Copy theanalyze-code.ymlfile into your repository at:.github/workflows/analyze-code.ymlThen commit and push the changes.
Make sure to update the workflow file with your GitHub username wherever required.
-
Generate a GitHub Personal Access Token (PAT)
You need a Personal Access Token (PAT) withrepopermissions.
Refer to GitHub Docs on how to generate one. -
Add the Token to Repository Secrets
- Go to Settings → Secrets and variables → Actions → New repository secret
- Name the secret
GH_PAT - Paste the generated token and save.
-
Update Workflow Permissions
In the repository where you're running the action, make sure to update workflow permissions:- Go to Settings → Actions → General.
- Under Workflow permissions, select "Read and write permissions".
- This allows the workflow to update files like
README.mdautomatically.
-
Trigger the Workflow
- The workflow runs by default every Sunday at midnight UTC (customizable).
- To run manually, go to GitHub Actions → Select Workflow → Run Workflow.
- To run on every push, modify the workflow's
on:section to:on: push: branches: - main
-
Wait for Processing
The time taken depends on the number of repositories and their sizes. Once completed, yourREADME.mdwill be updated with the latest lines of code breakdown. -
Ensure Placeholders Are Present
To allow automatic updates, yourREADME.mdmust include the following placeholders:<!-- LANGUAGES BREAKDOWN (STATIC EXAMPLE) START --> <!-- LANGUAGES BREAKDOWN (STATIC EXAMPLE) END -->The workflow will update the stats between these markers.
Remove(STATIC EXAMPLE)when adding it in your README, as it's just a placeholder. It's included here only to prevent automatic updates in this README.
By default, the workflow excludes some file types from counting:
cloc . --exclude-ext=json,html,css,svg,md,py,ps1,scss --json > ../output/cloc-output.jsonYou can modify this list in the workflow file to include or exclude specific languages based on your needs.
After execution, you can check the cloc-output.json file inside the output folder to see the full language breakdown.
For a complete list of supported languages, refer to cloc documentation.
Soon, I'll be pushing changes to configure workflow execution based on a JSON configuration.
This will allow you to:
- Specify which repositories the script should run on by default.
- Define whether to run on all branches or only specific branches for certain repositories.
This feature will be updated shortly.
Contributions are welcome! Feel free to fork the repository, submit a PR, or open an issue.