Sweepi

0.0.22 verified Fri May 01 auth: no javascript

Run Sweepit lint rules against a project without modifying its dependencies. Version 0.0.22, released as a standalone CLI tool. It uses a private toolchain in ~/.sweepi to avoid conflicts with project ESLint configs or lockfiles. Key differentiator: no installation into project devDependencies, no ESLint plugin pollution. Supports linting all TypeScript files or only changed files (git-aware). Requires Node >=22.13.0.

Common errors

error Error: Failed to initialize ~/.sweepi. Please run 'npx sweepi init' or ensure you have write permissions. ↓

cause Sweepi cannot create or write to ~/.sweepi directory (permissions or existing corrupted state).

fix

Run 'npx sweepi init' and check home directory permissions.

error Error: ESLint configuration error: Could not find config file ~/.sweepi/eslint.config.mjs ↓

cause Sweepi initialization was incomplete or the config file was deleted.

fix

Re-run 'npx sweepi init' to recreate the configuration.

error Error: Node.js version must be >=22.13.0. Current version is X.Y.Z ↓

cause Node version too old.

fix

Upgrade Node.js to version 22.13.0 or higher.

error Error: eslint-plugin-sweepit not found in ~/.sweepi/node_modules ↓

cause Init did not install dependencies properly.

fix

Delete ~/.sweepi and re-run 'npx sweepi init'.

Warnings

breaking Requires Node >=22.13.0. Older versions will fail to run. ↓

fix Upgrade Node to version >=22.13.0

gotcha Sweepi only lints .ts and .tsx files by default. Other file types are ignored. ↓

fix Use --all to include all files, but note it still only processes TypeScript files per current implementation.

gotcha Sweepi uses a separate ESLint installation in ~/.sweepi, which may have different plugin versions than the project. ↓

fix Ensure ~/.sweepi is reinitialized after major ESLint releases via `npx sweepi init`.

breaking Sweepi only lints changed files (staged, unstaged, untracked) by default. Running without --all may miss already committed issues. ↓

fix Use --all to lint entire project.

deprecated Global install of sweepi is not recommended; use npx ↓

fix Use npx sweepi instead of global install

Install

npm install sweepi

yarn add sweepi

pnpm add sweepi

Imports

default (CLI)
wrong
```
sweepi [project-dir] (if not installed globally)
```
correct
```
npx sweepi [project-dir]
```
Sweepi is a CLI tool; run via npx or globally install. No programmatic API.

Quickstart

Initialize Sweepi toolchain and lint all TypeScript files in the current directory.

npx sweepi init
npx sweepi . --all