fizzylint

0.1.4 verified Fri May 01 auth: no javascript

fizzylint v0.1.4 is a minimal JavaScript and TypeScript lint CLI focused on common code quality issues with safe autofixes. It checks for loose equality, var declarations, console/debugger statements, duplicate imports, trailing whitespace, empty blocks, TODO/FIXME comments, let-to-const opportunities, and explicit any in TypeScript. Unlike ESLint, it requires zero configuration and runs fast using heuristic-driven parsing. The CLI supports stdin, JSON output, quiet mode, file extension filtering, and max-warnings threshold. Ideal for quick ad-hoc linting without setup overhead.

Common errors

error fizzylint: error: unknown option '--format' ↓

cause The --format option does not exist.

fix

Use --json for JSON output instead.

error fizzylint lint: No files matched patterns provided ↓

cause Glob pattern did not match any files or directory does not exist.

fix

Verify file paths and extensions.

error fizzylint: error: required option '--stdin-filename' not specified ↓

cause Missing --stdin-filename when using --stdin.

fix

Add --stdin-filename <name> with the file to lint.

Warnings

gotcha fizzylint uses heuristic parsing, not a full AST. Some false positives/negatives may occur for complex code. ↓

fix Cross-check with ESLint for critical codebases.

gotcha --stdin requires --stdin-filename to be specified. ↓

fix Provide --stdin-filename with a file name (e.g., --stdin-filename src/example.ts).

breaking No breaking changes yet as version is below 1.0.0. ↓

fix Expect potential breaking changes before stable release.

Install

npm install fizzylint

yarn add fizzylint

pnpm add fizzylint

Imports

fizzylint
wrong
```
npm install -g fizzylint
```
correct
```
npx fizzylint lint src
```
Use npx to avoid global install. fizzylint is a CLI, not a library.
default
wrong
```
import fizzylint from 'fizzylint'
```
correct
```
CLI usage: fizzylint [command] [options]
```
fizzylint is a CLI tool, not a module. Do not attempt to import it programmatically.
fix
```
fizzylint fix src
```
Autofixes trailing whitespace, loose equality to strict, and let to const.

Quickstart

Lint all JS/TS files in src/ directory with JSON output and disabled color.

npx fizzylint lint 'src/**/*.{js,ts}' --json --no-color