Troubleshooting

Common Issues

Analysis Times Out

If analysis times out on large projects:

Run Knip directly to verify it works:
bash
```
npx knip --reporter json
```
Enable caching in your Knip config:
json
```
{
  "cache": true
}
```

Exclude heavy directories:

json

{
  "ignore": ["**/node_modules/**", "**/dist/**"]
}

See Knip Performance Guide for more tips.

False Positives

If Knip reports used code as unused:

Dynamic imports: Add entry points for dynamically imported files
External usage: Mark externally consumed exports
Framework patterns: Ensure framework plugins are enabled

See Knip Handling Issues Guide for solutions.

WebSocket Disconnected

If the connection status shows disconnected:

Ensure your dev server is running
Check for proxy configurations blocking WebSocket
Try a different browser

"Knip not found"

Ensure Knip is installed:

bash

pnpm add -D knip

Getting Help