codebase-inspection

Run pygount with the summary format: pygount --format=summary --folders-to-skip=".git,node_modules,venv" in the repository root. It outputs a table with per-language file counts, code lines, comment lines, and percentages.

Use pygount --format=summary to get a per-language table showing files, code, and comment lines. To focus on specific languages, add --suffix with extensions like py or yaml to filter the scan.

Pygount crawls every directory by default, including node_modules, venv, and .git, which contain thousands of dependency files. Always pass --folders-to-skip to exclude dependency and build directories before scanning.

Pygount classifies all Markdown content as comments, not code, so Markdown files always show zero code lines. This is expected behavior, and JSON files may also show conservative counts that can be cross-checked with wc -l.

Yes, pygount supports --format=json, which emits structured records with language, code_lines, doc_lines, and file counts. This output can be parsed by scripts for aggregation or integration into automation pipelines.

Full scans of very large monorepos can be slow even with folder exclusions. For these cases, use --suffix to target specific languages or scan modules separately rather than analyzing the entire repository at once.