console-insights

A powerful CLI tool to gain insights, find, report, and remove console.* statements from JavaScript, TypeScript, and JSX/TSX files.
Perfect for keeping your codebase clean and gaining visibility into logging before production, during code reviews, or as part of your CI/CD pipeline.

---

Features

• Count all console.* statements in your codebase.
• Report every console.* statement with file, line number, and code.
• Summary Table: See a per-file summary with counts and line numbers.
• Remove all or selected console.* statements, with:
  • --dry-run mode to preview changes.
  • --methods to target only specific console methods (e.g. log, warn).
  • --lines to target only specific line numbers.
• Supports modern JavaScript, TypeScript, JSX, and TSX syntax.
• Glob pattern support for flexible file selection.
• Safe: Ignores node_modules by default.

---

Installation

npm install -g console-insights

Or use with npx (no install needed):

npx console-insights <command> [options]

Usage

Count console statements

Count in a specific file:

console-insights count src/App.jsx

Count only console.log and console.warn in a specific file:

console-insights count src/App.jsx --methods log,warn

Count in all JS/JSX/TS/TSX files recursively:

console-insights count "**/*.{js,jsx,ts,tsx}"

Count only console.error in all files:

console-insights count "**/*.{js,jsx,ts,tsx}" --methods error

Report all console statements (file, line, code)

Report in a specific file:

console-insights report src/App.jsx

Report only console.log and console.warn in a specific file:

console-insights report src/App.jsx --methods log,warn

Report in all files:

console-insights report "**/*.{js,jsx,ts,tsx}"

Report only console.error in all files:

console-insights report "**/*.{js,jsx,ts,tsx}" --methods error

Show a summary table

Summary for a specific file:

console-insights summary src/App.jsx

Summary for all files:

console-insights summary "**/*.{js,jsx,ts,tsx}"

Remove console statements

Remove from a specific file:

console-insights remove src/App.jsx

Remove from all files:

console-insights remove "**/*.{js,jsx,ts,tsx}"

Dry run (preview what would be removed)

console-insights remove src/App.jsx --dry-run

Remove only specific methods

console-insights remove src/App.jsx --methods log,warn

Remove only on specific lines

console-insights remove src/App.jsx --lines 10,15

Combine options

console-insights remove src/App.jsx --methods log,warn --lines 10,15 --dry-run

Example Usage Table

Command Example	What it Does
console-insights count src/App.jsx	Count all console statements in a file
console-insights count src/App.jsx --methods log,warn	Count only console.log and console.warn in a file
console-insights report src/App.jsx	List all console statements in a file
console-insights report src/App.jsx --methods log,warn	List only console.log and console.warn in a file
console-insights summary src/App.jsx	Show summary for a single file
console-insights remove src/App.jsx	Remove all console statements from a file
console-insights count "**/*.js"	Count all console statements in JS files
console-insights count "**/*.js" --methods error	Count only console.error in JS files
console-insights report "src/**/*.{js,jsx}"	List all console statements in src/
console-insights report "src/**/*.{js,jsx}" --methods warn	List only console.warn in src/
console-insights summary "**/*.{js,jsx,ts,tsx}"	Show summary table for all code files
console-insights remove "**/*.js" --dry-run	Show what would be removed (no changes)
console-insights remove "**/*.js" --methods log,warn	Remove only console.log and console.warn
console-insights remove "**/*.js" --lines 10,15	Remove consoles only on lines 10 and 15
console-insights remove "**/*.js" --methods log --lines 10,15	Remove console.log only on lines 10, 15

Options

Option	Description
--dry-run	Show what would be removed, but do not modify files
--methods	Comma-separated list of console methods to count/report/remove (e.g. log,warn)
--lines	Comma-separated list of line numbers to remove (e.g. 10,15)

Why use console-insights?

• Gain insights into your codebase's logging.
• Keep your codebase clean before production.
• Automate code review for forgotten debug logs.
• Integrate with CI/CD to enforce no-console policies.
• Flexible and safe: preview changes, target only what you want.

Typical Use Cases

• Pre-deployment cleanup: Remove all debug logs before production.
• Code review: Audit for forgotten console.* statements.
• CI/CD integration: Fail builds if any console.* statements remain.
• Selective removal: Remove only certain types or lines of console statements.

License

MIT

Contributing

Pull requests and issues are welcome! If you have ideas for new features or improvements, please open an issue or PR.

Author

Gitesh Pareek
https://www.linkedin.com/in/itsgitesh/