Codestats

A Rust CLI that summarizes codebases at blazing speed. It counts files, lines, and bytes by language; respects .gitignore and .ignore files; can follow symlinks; optionally displays per-file details; and outputs in either human-readable or machine-friendly formats.

Installation

With cargo

cargo install codestats

From source

git clone https://github.com/trypsynth/codestats
cd codestats
cargo install --path .

Quick start

• Analyze the current directory and provide a human-readable report: cs
• Get a verbose, per-file detail for src/ in JSON format: cs -v src -o json
• List supported languages (400+): cs -l

Configuration

Codestats can read settings from TOML while keeping full CLI compatibility. Precedence: CLI args > explicit --config path > nearest found file > built-in defaults.

Search order:

1. --config <path> (errors if missing)
2. ./.codestats.toml
3. ./codestats.toml
4. ~/.config/codestats/config.toml
5. ~/.codestats.toml

Example .codestats.toml:

[analysis]
verbose = false
respect_gitignore = true
include_hidden = false
follow_symlinks = false

[display]
number_style = "plain"        # plain|comma|underscore|space
size_units = "binary"         # binary|decimal
precision = 1                 # 0-6
sort_by = "lines"             # lines|code|comments|blanks|files|size|name
sort_direction = "desc"       # asc|desc
output = "human"              # human|json|json-compact|csv|tsv|markdown|html

CLI reference

Usage: cs [OPTIONS] [PATH]

Arguments

• PATH The path to analyze (directory is recursive). Defaults to the current directory.

Options

• -c, --config <PATH> Path to a TOML config file.
• -l, --langs List all supported languages and exit.
• -v, --verbose Show per-file detail instead of just the summary.
• -i, --no-gitignore Do not respect .gitignore files.
• -H, --hidden Search hidden files and directories.
• -s, --symlinks Follow symlinks (use carefully to avoid cycles).
• -n, --number-style <plain|comma|underscore|space> Number formatting style. Default: plain.
• -u, --size-units <binary|decimal> Human-readable size units. Default: binary.
• -p, --precision <0-6> Percentage precision. Default: 1.
• -S, --sort-by <lines|code|comments|blanks|files|size|name> Sort key for languages (and per-file detail when verbose). Default: lines.
• -d, --sort-dir <asc|desc> Sort direction. Default: desc.
• -o, --output <human|json|json-compact|csv|tsv|markdown|html> Output format. Default: human.
• -h, --help Print help.
• -V, --version Print version.

Benchmarks

hyperfine --warmup 1 "target/release/cs /home/quin" "tokei /home/quin"

Command	Mean ± σ	Min … Max
cs /home/quin	2.606 s ± 0.024 s	2.587 s … 2.643 s
tokei /home/quin	9.396 s ± 0.029 s	9.364 s … 9.442 s

Codestats ran about 3.6 times faster than tokei on this machine (a modest Beelinks mini PC) when scanning my large home directory with caches warmed up.

License

Codestats is licensed under the Zlib License.