console-log-remove

> Find and remove console.log statements from your code - safely and quickly


Problem

You have 500 console.log() scattered everywhere. Production deploy is in 10 minutes.

Solution

console-log-remove finds and removes console statements safely, with options to keep error/warn and create backups.

Features

- Find all console statements - Scans your entire codebase
- Keep what matters - Keep console.error and console.warn with flags
- Dry run mode - Preview changes before applying
- Automatic backups - Never lose code accidentally
- TypeScript + JavaScript - Works with .ts, .tsx, .js, .jsx, .mjs, .cjs
- Smart removal - Handles multi-line statements and removes empty lines
- Fast - Uses fast-glob for quick scanning

Installation

``bash


Run directly with npx (recommended)

npx console-log-remove

Or install globally

npm install -g console-log-remove

Short alias

npx clr
`

Usage

$3

`bash


See what would be removed without making changes

npx console-log-remove --dry-run

Preview in a specific directory

npx console-log-remove ./src --dry-run
`

$3

`bash


Remove all console statements

npx console-log-remove --remove-all

Keep console.error and console.warn

npx console-log-remove --remove-all --keep-error --keep-warn

Or use --keep flag

npx console-log-remove --remove-all --keep error,warn,info
`

$3

`bash


Just show stats, don't remove anything


npx console-log-remove --stats
`

Example Output

$3

`
🔍 Found 47 console statements:

By type:
console.log: 35
console.error: 8
console.warn: 4

📁 src/utils/api.ts
L23: console.log('API response:', data)
L45: console.error('Error:', err)
L67: console.log('Request:', config)

📁 src/components/Login.tsx
L12: console.log('User:', user)
L34: console.warn('Deprecated prop used')

Options:
--remove-all Remove all console statements
--keep-error Keep console.error
--keep-warn Keep console.warn
--dry-run Preview without changes

Example:
npx console-log-remove --remove-all --keep-error --keep-warn
`

$3

`
🔍 Dry Run - No files will be modified

📁 src/utils/api.ts
L23: console.log('API response:', data) [REMOVE]
L45: console.error('Error:', err) [KEEP]

📁 src/components/Login.tsx
L12: console.log('User:', user) [REMOVE]
L34: console.warn('Deprecated prop used') [KEEP]

──────────────────────────────────────────────────
Summary:
Would remove: 35
Would keep: 12

Run without --dry-run to apply changes.
`

$3

`
✓ src/utils/api.ts
Removed: 2, Kept: 1
Backup: src/utils/api.ts.backup

✓ src/components/Login.tsx
Removed: 1, Kept: 1
Backup: src/components/Login.tsx.backup

✅ Removed 35 console statements.
Kept 12 statements (error/warn or skipped).
`

Comparison with Alternatives

| Feature | console-log-remove | ESLint no-console | babel-plugin | Manual |
|---------|-------------------|-------------------|--------------|--------|
| Find statements | ✅ | ✅ | ❌ | ❌ |
| Selective removal | ✅ | ⚠️ (config) | ❌ | ✅ |
| Keep error/warn | ✅ | ⚠️ (config) | ⚠️ | ✅ |
| Preview changes | ✅ | ❌ | ❌ | ❌ |
| Automatic backup | ✅ | ❌ | ❌ | ❌ |
| Statistics | ✅ | ❌ | ❌ | ❌ |
| Multi-line support | ✅ | ✅ | ✅ | ⚠️ |
| No config needed | ✅ | ❌ | ❌ | ✅ |

CLI Options

`
Usage: console-log-remove [options] [path]

Arguments:
path Directory to scan (default: ".")

Options:
--dry-run Preview changes without modifying files
--remove-all Remove all console statements
--keep-error Keep console.error statements
--keep-warn Keep console.warn statements
--keep Comma-separated methods to keep (e.g., error,warn)
--no-backup Do not create backup files
--include Glob patterns to include (comma-separated)
--exclude Glob patterns to exclude (comma-separated)
--json Output results as JSON
--stats Show statistics only
-V, --version Output version number
-h, --help Display help
`

Supported Console Methods

All console methods are detected:
- console.log, console.debug, console.info
- console.warn, console.error
- console.trace, console.table, console.dir
- console.time, console.timeEnd, console.timeLog
- console.group, console.groupEnd, console.groupCollapsed
- console.count, console.countReset
- console.assert, console.clear
- console.profile, console.profileEnd

Programmatic Usage

`typescript
import { scanDirectory, removeFromFile, filterStatements } from 'console-log-remove';

// Scan a directory
const result = await scanDirectory('./src');

console.log(Found ${result.totalStatements} console statements);

// Remove from specific file
for (const fileResult of result.files) {
// Keep error and warn
const toRemove = filterStatements(fileResult.statements, ['error', 'warn']);

if (toRemove.length > 0) {
removeFromFile(fileResult, toRemove, true); // true = create backup
}
}
`

CI/CD Integration

`yaml


GitHub Actions - fail if console.log found


- name: Check for console statements
run: |
npx console-log-remove --stats --json > console-check.json
COUNT=$(cat console-check.json | jq '.byMethod.log // 0')
if [ "$COUNT" -gt 0 ]; then
echo "Found $COUNT console.log statements!"
exit 1
fi
`

Restore from Backup

Backups are created with .backup extension:

`bash


Restore a single file

mv src/utils/api.ts.backup src/utils/api.ts

Restore all backups

find . -name "*.backup" -exec sh -c 'mv "$1" "${1%.backup}"' _ {} \;

Remove all backups (after verifying changes)

find . -name "*.backup" -delete
``

Requirements

- Node.js 18.0.0 or higher

Support

This project is maintained in my free time. If it saved you from embarrassing console.logs in production, I'd really appreciate your support:

- ⭐ Star the repo—it helps others discover this tool
- 📢 Share with your team or on social media
- 🐛 Report bugs or suggest features
- ☕ Buy me a coffee if you'd like to support development

Thank you to everyone who has contributed, shared feedback, or helped spread the word!

License

MIT

---

Made with ❤️ for cleaner production code