Universal Linter & Formatter

Auto-detect project type and run appropriate formatters and linters with auto-fix.

Arguments

• $ARGUMENTS: Specific path or file to lint (optional - uses current directory)

Detection & Tools

Python Projects

Formatters:

• black - Code formatter
• isort - Import sorter

Linters:

• flake8 - Style checker
• mypy - Type checker
• ruff - Fast linter (replaces flake8, isort)

Execution Order:

# 1. Sort imports
uv run isort $PATH --profile black
# or with ruff
uv run ruff check --select I --fix $PATH

# 2. Format code
uv run black $PATH

# 3. Lint (auto-fix what's possible)
uv run ruff check --fix $PATH
# or
uv run flake8 $PATH

# 4. Type check (no auto-fix)
uv run mypy $PATH

JavaScript/TypeScript Projects

Formatters:

• prettier - Code formatter

Linters:

• eslint - Linter with auto-fix

Execution Order:

# 1. Format with Prettier
npx prettier --write $PATH
# or with pnpm
pnpm prettier --write $PATH

# 2. Lint with ESLint (auto-fix)
npx eslint --fix $PATH
# or
pnpm eslint --fix $PATH

# 3. Type check (TypeScript only)
npx tsc --noEmit

Project-Specific Configurations

Pre-commit Integration

Many projects use pre-commit hooks. Run manually:

# Python projects
pre-commit run --all-files

# This runs all configured hooks:
# - black
# - flake8
# - isort
# - cleanpy (remove __pycache__)

Staged Files Only

For commit preparation, lint only staged files:

# Python
git diff --cached --name-only --diff-filter=ACMR | grep '\.py$' | xargs black
git diff --cached --name-only --diff-filter=ACMR | grep '\.py$' | xargs flake8

# JavaScript/TypeScript
git diff --cached --name-only --diff-filter=ACMR | grep -E '\.(js|jsx|ts|tsx)$' | xargs npx prettier --write
git diff --cached --name-only --diff-filter=ACMR | grep -E '\.(js|jsx|ts|tsx)$' | xargs npx eslint --fix

Output Format

Lint & Format: [project-name]
Path: [path or .]
Project Type: [Python/JavaScript/TypeScript]

1. Formatting...
   [Formatter output]
   Files formatted: X

2. Linting...
   [Linter output]
   Issues fixed: Y
   Issues remaining: Z

3. Type Checking...
   [Type checker output]
   Type errors: N

Summary:
  Formatted: X files
  Auto-fixed: Y issues
  Manual fixes needed: Z issues
  Type errors: N

Common Issues & Fixes

Python

• Line too long: Black handles this, or add # noqa: E501
• Import order: isort or ruff check --select I --fix
• Unused imports: ruff check --select F401 --fix

JavaScript/TypeScript

• Unused variables: ESLint --fix with no-unused-vars
• Missing semicolons: Prettier handles this
• Inconsistent quotes: Prettier handles this

Skip Linting

For files that should be skipped:

# Python: Add to file
# flake8: noqa
# type: ignore

// JavaScript: Add to file
/* eslint-disable */
// prettier-ignore