Work Loc

LOC Counter - Lines of Code Statistics

Bismillah! Count lines of code across repositories or directories using tokei.

Arguments: <repo-list|path> [--summary]

Command Purpose

This command:

• Counts LOC across one or multiple repositories
• Uses tokei for accurate, language-aware counting
• Outputs detailed breakdown by language
• Supports summary mode for quick totals

Implementation

Step 1: Check tokei Installation

First, verify tokei is installed:

if ! command -v tokei &> /dev/null; then
    echo "tokei not found. Installing via cargo..."
    cargo install tokei
fi

Step 2: Parse Arguments

The command accepts:

• No args: Count LOC in current directory
• Repo names: Space-separated list of repo names (looked up in $LOC_WORKSPACE, default ~/local-dev)
• Paths: Absolute or relative paths to directories
• --summary: Only show totals, not per-repo breakdown
• --json: Output as JSON for parsing

Step 3: Execute Count

For current directory (no args):

tokei .

For specific repos:

REPOS="<repo names from the invocation arguments>"
for repo in $REPOS; do
    path="${LOC_WORKSPACE:-$HOME/local-dev}/$repo"
    if [ -d "$path" ]; then
        echo "=== $repo ==="
        tokei "$path" --compact
    fi
done

For organization-wide (example with your-org):

REPOS="your-app your-api your-docs your-cli your-sdk your-website"
for repo in $REPOS; do
    path="${LOC_WORKSPACE:-$HOME/local-dev}/$repo"
    if [ -d "$path" ]; then
        echo "=== $repo ==="
        tokei "$path" --compact
        echo ""
    fi
done

Step 4: Generate Summary Table

After counting all repos, generate a markdown summary table with:

• Repository name
• Total files
• Total lines
• Code lines
• Comments
• Blanks

Usage Examples

# Count LOC in current directory
work-loc

# Count LOC in specific repos
work-loc your-app your-api

# Count with summary only (no per-language breakdown)
work-loc --summary

# Count in absolute path
work-loc /path/to/project

# Count all your-org repos
work-loc your-org

Expected Output

Per-repo breakdown:

=== your-repo ===
 Language    Files   Lines    Code  Comments  Blanks
 Rust          42   22408   18127      1151    3130
 Markdown      40   16042       0     11568    4474
 ...

Summary table:

| Repository | Files | Lines | Code | Comments | Blanks |
|------------|-------|-------|------|----------|--------|
| your-repo  | 103   | 49888 | 25633| 15340    | 8915   |
| TOTAL      | 378   | 120K  | 70K  | 31K      | 18K    |

Special Keywords

• your-org - Count all your-org organization repos
• --compact - Use compact tokei output
• --summary - Show only final summary table
• --json - Output raw JSON for parsing

Notes

• Performance: Fast for most repos (< 5s per repo)
• Prerequisites: tokei must be installed (auto-installs via cargo if missing)
• Excludes: Auto-ignores .git, node_modules, target, vendor directories
• Languages: Supports 200+ programming languages

Template Version: 1.0 Created: 2025-12-07

Alhamdulillah!