Codebase Counter CLI

v2.0.7

An advanced command-line tool to analyze your codebase.

Count files, view your project tree, measure lines of code, find your biggest files, see language breakdowns, and generate complete codebase reports.

Created by Arham Kazim Mohammed

Installation

Install globally with npm:

npm install -g codebase-file-counter

Run:

codebase-count

Features

• 📦 Count files in your codebase
• 📁 Count folders
• 🌳 Display project tree
• 📏 Count lines of code
• 🏆 Find largest files
• 💻 Show programming language breakdown
• 📊 Generate complete codebase statistics
• 🤖 Export stats as JSON

Commands

Show banner

codebase-count

Displays the Codebase Counter CLI banner and information.

Help

codebase-count help

or:

codebase-count --help

Shows all available commands and options.

Count files

codebase-count files

Example:

📦 Codebase files: 103

Show tree

codebase-count tree

Displays your project folder structure.

Example:

├── src
│   ├── index.js
│   └── utils
├── package.json
└── README.md

Count lines

codebase-count lines

Shows total lines of code.

Example:

📏 Lines of Code: 54231

Biggest files

codebase-count largest

Shows the files with the most lines.

Example:

🏆 Biggest Files

1. app.tsx - 2341 lines
2. api.ts - 1823 lines
3. index.css - 900 lines

Language breakdown

codebase-count languages

Example:

💻 Languages

TypeScript: 21430 lines
JavaScript: 18200 lines
CSS: 5400 lines
HTML: 2100 lines

Full statistics

codebase-count stats

Shows:

• 📦 Total files
• 📁 Total folders
• 🌳 Tree summary
• 📏 Lines of code
• 🏆 Biggest files
• 💻 Languages

Example:

📊 Codebase Report

📦 Files
   Total: 103

📁 Folders
   Total: 20

📏 Lines of Code
   Total: 54231

🏆 Biggest Files

1. app.tsx - 2341 lines

💻 Languages

TypeScript: 21430 lines
JavaScript: 18200 lines

JSON output

For scripts and automation:

codebase-count stats --json

Example:

{
  "summary": {
    "files": 103,
    "folders": 20,
    "lines": 54231
  },
  "largestFiles": [],
  "languages": {}
}

Ignored Files

Codebase Counter ignores:

node_modules/
.git/
.next/
dist/
build/

README files are excluded from line counting.

License

MIT License

Created by Arham Kazim Mohammed