Skip to content

Issue Types

Knip reports the following types of issues:

Title Description Key
Unused files Unable to find a reference to this file πŸ”§ files
Unused dependencies Unable to find a reference to this dependency πŸ”§ dependencies
Unused devDependencies Unable to find a reference to this devDependency πŸ”§ dependenciesΒ²
Referenced optional peerDependencies Optional peer dependency is referenced dependenciesΒ²
Unlisted dependencies Used dependencies not listed in package.json unlisted
Unlisted binaries Binaries from dependencies not listed in package.json binaries
Unused catalog entries Unable to find a reference to this catalog entry πŸ”§ catalog
Unresolved imports Unable to resolve this (import) specifier unresolved
Unused exports Unable to find a reference to this export πŸ”§ exports
Unused exported types Unable to find a reference to this exported type πŸ”§ types
Exports in used namespace Namespace with export is referenced, but not export itself πŸ”§ 🟠 nsExports
Exported types in used namespace Namespace with type is referenced, but not type itself πŸ”§ 🟠 nsTypes
Unused exported enum members Unable to find a reference to this enum member πŸ”§ enumMembers
Unused exported namespace members Unable to find a reference to this namespace member πŸ”§ namespaceMembers
Duplicate exports This is exported more than once duplicates
Circular dependencies These files (in)directly import each other at runtime 🟠 cycles
Description
πŸ”§ Auto-fixable issue types
🟠 Not included by default (include with filters)
  1. When an issue type has zero issues, it is not shown.
  2. Including or excluding dependencies (via CLI or configuration) automatically includes or excludes devDependencies and optionalPeerDependencies. In rules, each key can be set individually.
  3. In strict production mode, devDependencies are not included.
  4. The types issue type includes enum, interface and type exports.
  5. cycles defaults to the warn rule (reported, but not counted as an error). Set rules.cycles to error to fail on circular dependencies.

ISC License Β© 2026Lars Kappert