soroushosouli/node-scout

A fast CLI for exploring and analyzing systems, files, and projects.

JavaScript

3

45 commits

updated Oct 8, 2026

See the code

See what people are saying

SourceMessageScoreDate

The CLI that scans your project in a fraction of a second. (r/javascript)

Link2Repo: [https://github.com/soroushosouli/node-scout](https://github.com/soroushosouli/node-scout) Written in *Node.js*. One command to install. Reads a 300MB folder in **\~1 second**. Smaller project, faster scan. **What it does:** * Visualize folder structure (tree) * Scan any file, folder, or…

3

Oct 10, 2026

README

🔎 Node Scout

A fast Node.js CLI tool to analyze files, folders, and projects from your terminal.

npm version npm downloads license node

Node Scout helps you inspect any codebase in seconds. One command gives you file stats, folder structure, project languages, total size, and system info.

Contents

Demo

System info File analysis Folder analysis Project analysis Folder tree

Features

📄 Files — type, language, size, lines, words, characters, created date.

📁 Folders — file count, folder count, total size, contents.

🗂️ Projects — structure, languages, file stats, total size.

📋 Custom Ignore List — Add files/folders to the list you don't want to be scanned in project scanning.

🌳 Folder Tree — Folder tree visualizer.

💻 System — useful info about your machine.

Install

Requires Node.js 16+.

npm install -g node-scout

Or run without installing:

npx node-scout --help

Usage

scout <target> <path>
TargetDescription
fileAnalyze a single file
folderAnalyze a folder
projectAnalyze an entire project
systemShow system information
treeShow folder tree

Other commands: scout help, scout version, scout ignore add/remove.

Examples

scout project ./my-project
scout folder ./src
scout file package.json
scout tree ./myproject
scout system
scout ignore add assets

Example output for scout project ./my-project:

Project: my-project
Files: 128
Folders: 24
Languages: JavaScript, TypeScript, JSON, Markdown
Total size: 4.8 MB

Contributing

PRs Welcome

Found a bug or have an idea? Contributions are welcome.

  1. Fork the repo
  2. Create a branch
  3. Commit your changes
  4. Open a pull request

License

MIT

cli
code-analysis
command-line-tool
developer-tools
file-analysis
javascript
nodejs
npm-package
project-analyzer

soroushosouli/node-scout

A fast CLI for exploring and analyzing systems, files, and projects.

JavaScript

3

45 commits

updated Oct 8, 2026

See the code

See what people are saying

SourceMessageScoreDate

The CLI that scans your project in a fraction of a second. (r/javascript)

Link2Repo: [https://github.com/soroushosouli/node-scout](https://github.com/soroushosouli/node-scout) Written in *Node.js*. One command to install. Reads a 300MB folder in **\~1 second**. Smaller project, faster scan. **What it does:** * Visualize folder structure (tree) * Scan any file, folder, or…

3

Oct 10, 2026

README

🔎 Node Scout

A fast Node.js CLI tool to analyze files, folders, and projects from your terminal.

npm version npm downloads license node

Node Scout helps you inspect any codebase in seconds. One command gives you file stats, folder structure, project languages, total size, and system info.

Contents

Demo

System info File analysis Folder analysis Project analysis Folder tree

Features

📄 Files — type, language, size, lines, words, characters, created date.

📁 Folders — file count, folder count, total size, contents.

🗂️ Projects — structure, languages, file stats, total size.

📋 Custom Ignore List — Add files/folders to the list you don't want to be scanned in project scanning.

🌳 Folder Tree — Folder tree visualizer.

💻 System — useful info about your machine.

Install

Requires Node.js 16+.

npm install -g node-scout

Or run without installing:

npx node-scout --help

Usage

scout <target> <path>
TargetDescription
fileAnalyze a single file
folderAnalyze a folder
projectAnalyze an entire project
systemShow system information
treeShow folder tree

Other commands: scout help, scout version, scout ignore add/remove.

Examples

scout project ./my-project
scout folder ./src
scout file package.json
scout tree ./myproject
scout system
scout ignore add assets

Example output for scout project ./my-project:

Project: my-project
Files: 128
Folders: 24
Languages: JavaScript, TypeScript, JSON, Markdown
Total size: 4.8 MB

Contributing

PRs Welcome

Found a bug or have an idea? Contributions are welcome.

  1. Fork the repo
  2. Create a branch
  3. Commit your changes
  4. Open a pull request

License

MIT

cli
code-analysis
command-line-tool
developer-tools
file-analysis
javascript
nodejs
npm-package
project-analyzer

Project health

Latest release

2.0.1 · Oct 8, 2026

Releases this year

11