{"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,"search_vec":"'/.sweepi':27 '0.0.22':14 '22.13.0':62 'avoid':29 'awar':59 'chang':55 'cli':19 'config':34 'conflict':30 'depend':12 'devdepend':43 'differenti':38 'eslint':33,45 'file':52,56 'git':58 'git-awar':57 'instal':40 'javascript':63 'key':37 'lint':4,49 'lockfil':36 'modifi':10 'node':61 'plugin':46 'pollut':47 'privat':24 'project':8,32,42 'releas':15 'requir':60 'rule':5 'run':2 'standalon':18 'support':48 'sweepi':1 'sweepit':3 'tool':20 'toolchain':25 'typescript':51,64 'use':22 'version':13 'without':9","created_at":"2026-05-01T13:50:04.293281+00:00","updated_at":"2026-05-01T13:50:04.293281+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"sweepi","cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/sweepi","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops","testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-05-01","next_check":"2026-07-30","install_tag":null}}