Code Stats CLI

code-stats is a powerful, configurable command-line tool for analyzing source code. It helps developers measure code quality, structure, complexity, and productivity across multiple programming languages and file types. Perfect for personal projects, team projects, or CI/CD pipelines.

🔹 Features

• Line Counting: Total lines, code lines, blank lines, and comment lines.
• Function Analysis: Count functions/methods and calculate average function length.
• Complexity Estimation: Rough complexity scoring using common keywords.
• Language Detection: Supports multiple languages and config file types.
• File Type Filtering: Scan only code files (--only-code) or config files (--only-config).
• Largest Files: Identify the top N largest files by code lines.
• Progress Feedback: Interactive progress bar for large projects.
• Output Options: Pretty table or JSON output (--json).
• Colored CLI Interface: Easy-to-read, visually structured outputs.
• Customizable: Ignore directories, filter by language, and more.

🔹 Installation

# Clone repository
git clone https://github.com/yourusername/code-stats.git
cd code-stats

# Install dependencies
npm install

# Optional: Make CLI available globally
npm link

Basic scan in current directory

code-stats .

Scan and count comment lines

code-stats . -c

Count functions/methods

code-stats . -f

Show average function length

code-stats . -a

Filter by specific language extensions

code-stats . -l js ts py

Only scan code files

code-stats . --only-code

Only scan config/markup files

code-stats . --only-config

Show top 10 largest files by code lines

code-stats . --largest 10

Save results in JSON

code-stats . --json

Ignore directories

code-stats . --ignore node_modules dist

| Option | Alias | Description | | -------------------------------- | ----- | --------------------------------------- | | [directory] | - | Directory to scan (default: .) | | -c, --count-comments | - | Count comment lines | | -f, --function-count | - | Count number of functions/methods | | -a, --avg-func-length | - | Show average function length in lines | | -l, --language <extensions...> | - | Only scan certain languages/extensions | | --ignore <dirs...> | - | Directories to ignore | | --only-code | - | Only scan code files | | --only-config | - | Only scan config/markup files | | --largest <n> | - | Show top N largest files (default: 5) | | --json | - | Output JSON to code-stats/report.json |

🔹 Supported Languages & File Types Code Files

js, ts, jsx, tsx, py, java, cpp, c, cs, rb, php, go, rs, kt, swift, dart, sh

Config / Markup Files

env, toml, ini, yml, yaml, json, xml, plist, gradle, makefile

Language detection is based on file extensions. Unknown extensions are labeled as Unknown.

┌─────────┬─────────────────────────┬───────────┬───────┬───────┬────────────┬──────────┬────────────┐ │ (index) │ File │ Lang │ Lines │ Code │ Comments │ Complexity │ Functions │ ├─────────┼─────────────────────────┼───────────┼───────┼───────┼────────────┼──────────┼────────────┤ │ 0 │ src/index.js │ JavaScript│ 100 │ 70 │ 20 │ 15 │ 5 │ │ 1 │ src/utils/helpers.ts │ TypeScript│ 50 │ 40 │ 5 │ 8 │ 3 │ └─────────┴─────────────────────────┴───────────┴───────┴───────┴────────────┴──────────┴────────────┘

=== Summary === Total Lines: 150 Total Code: 110 Total Comments: 25 Average Density: 73.3% Average Complexity: 11.5

{ "files": [ { "file": "src/index.js", "lang": "JavaScript", "lines": 100, "blanks": 10, "comments": 20, "codeLines": 70, "density": "70.0", "complexity": 15, "functions": 5, "avgFuncLength": 14 } ] }