Skip to content

Getting Started

Prerequisites

trueloc requires the GitHub CLI (gh) to be installed and authenticated:

# Install GitHub CLI (if not already installed)
# macOS
brew install gh

# Ubuntu/Debian
sudo apt install gh

# Windows
winget install GitHub.cli

Then authenticate:

gh auth login

Installation

uv tool install trueloc

uvx trueloc count USERNAME --since 1m

pip install trueloc

pipx install trueloc

git clone https://github.com/basnijholt/trueloc.git
cd trueloc
pip install -e .

Verify Installation

trueloc --help

You should see the available commands and options.

Your First Count

Count your lines of code from the last month:

trueloc count YOUR_USERNAME --since 1m

This will:

  1. Find your repositories plus every repository you contributed to (including organization, upstream, and private repos)
  2. Find merged PRs and direct commits since the specified date
  3. Count lines added and deleted across all commits
  4. Display a summary with per-PR breakdown and file type analysis

Next Steps