artivilla/agents-config/knip

Knip Code Cleanup

Run knip to find and remove unused files, dependencies, and exports from this codebase.

Setup

1. Check if knip is available:

• Run npx knip --version to test
• If it fails or is very slow, check if knip is in package.json devDependencies
• If not installed locally, install with npm install -D knip (or pnpm/yarn equivalent based on lockfile present)

1. If no knip.json or knip.jsonc config exists and knip reports many false positives, consider creating a minimal config based on the frameworks detected in package.json

Execution

1. Run npx knip to get initial report
2. Review the output categories:

• Unused files - files not imported anywhere
• Unused dependencies - packages in package.json not imported
• Unused devDependencies - dev packages not used
• Unused exports - exported functions/variables not imported elsewhere
• Unused types - exported types not used

Cleanup Strategy

Auto-delete (high confidence):

• Unused exports that are clearly internal (not part of public API)
• Unused type exports
• Unused dependencies (remove from package.json)
• Unused files that are clearly orphaned (not entry points, not config files)

For these, proceed with deletion without asking. Use --fix --allow-remove-files for automated fixes, or manually delete/edit as needed.

Ask first (needs clarification):

• Files that might be entry points or dynamically imported
• Exports that might be part of a public API (index.ts, lib exports)
• Dependencies that might be used via CLI or peer dependencies
• Anything in paths like src/index, lib/, or files with "public" or "api" in the name

Use the AskUserQuestion tool to clarify before deleting these.

Workflow

1. Run knip, capture full output
2. Categorize each issue as auto-delete or needs-clarification
3. Ask about uncertain items in a single batch question
4. Perform all deletions (use Edit tool to remove exports, Bash to remove files/deps)
5. Re-run knip to verify cleanup is complete
6. Repeat until no issues remain or only intentionally-ignored items exist

Common Commands

# Basic run
npx knip
 
# Production only (ignore test files)
npx knip --production
 
# Auto-fix what's safe
npx knip --fix
 
# Auto-fix including file deletion
npx knip --fix --allow-remove-files
 
# JSON output for parsing
npx knip --reporter json

Notes

• If knip config exists, respect its ignore patterns
• Watch for monorepo setups - may need --workspace flag
• Some frameworks need plugins enabled in config
• Re-run after each batch of fixes to catch newly-exposed unused code