{"id":26454,"library":"sweepi","title":"Sweepi","description":"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.","status":"active","version":"0.0.22","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","typescript"],"install":[{"cmd":"npm install sweepi","lang":"bash","label":"npm"},{"cmd":"yarn add sweepi","lang":"bash","label":"yarn"},{"cmd":"pnpm add sweepi","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Sweepi installs ESLint internally in ~/.sweepi","package":"eslint","optional":true},{"reason":"The core lint rules used by Sweepi","package":"eslint-plugin-sweepit","optional":true}],"imports":[{"note":"Sweepi is a CLI tool; run via npx or globally install. No programmatic API.","wrong":"sweepi [project-dir] (if not installed globally)","symbol":"default (CLI)","correct":"npx sweepi [project-dir]"}],"quickstart":{"code":"npx sweepi init\nnpx sweepi . --all","lang":"typescript","description":"Initialize Sweepi toolchain and lint all TypeScript files in the current directory."},"warnings":[{"fix":"Upgrade Node to version >=22.13.0","message":"Requires Node >=22.13.0. Older versions will fail to run.","severity":"breaking","affected_versions":"<0.0.22"},{"fix":"Use --all to include all files, but note it still only processes TypeScript files per current implementation.","message":"Sweepi only lints .ts and .tsx files by default. Other file types are ignored.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Ensure ~/.sweepi is reinitialized after major ESLint releases via `npx sweepi init`.","message":"Sweepi uses a separate ESLint installation in ~/.sweepi, which may have different plugin versions than the project.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Use --all to lint entire project.","message":"Sweepi only lints changed files (staged, unstaged, untracked) by default. Running without --all may miss already committed issues.","severity":"breaking","affected_versions":">=0.0.1"},{"fix":"Use npx sweepi instead of global install","message":"Global install of sweepi is not recommended; use npx","severity":"deprecated","affected_versions":">=0.0.1"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'npx sweepi init' and check home directory permissions.","cause":"Sweepi cannot create or write to ~/.sweepi directory (permissions or existing corrupted state).","error":"Error: Failed to initialize ~/.sweepi. Please run 'npx sweepi init' or ensure you have write permissions."},{"fix":"Re-run 'npx sweepi init' to recreate the configuration.","cause":"Sweepi initialization was incomplete or the config file was deleted.","error":"Error: ESLint configuration error: Could not find config file ~/.sweepi/eslint.config.mjs"},{"fix":"Upgrade Node.js to version 22.13.0 or higher.","cause":"Node version too old.","error":"Error: Node.js version must be >=22.13.0. Current version is X.Y.Z"},{"fix":"Delete ~/.sweepi and re-run 'npx sweepi init'.","cause":"Init did not install dependencies properly.","error":"Error: eslint-plugin-sweepit not found in ~/.sweepi/node_modules"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}