Getting Started

Requirements

Knip v5 requires Node.js v18.6 or higher. Or Bun.

Installation

This is the easiest and recommended way to install Knip:

npm

npm init @knip/config

pnpm

pnpm create @knip/config

yarn

yarn create @knip/config

Now you can run Knip to lint your project:

npm

npm run knip

pnpm

pnpm knip

bun

bun knip

yarn

yarn knip

Knip will lint your project and report unused files, dependencies and exports.

You can skip the rest of this page and go to configuration.

Manual

Alternatively, you can manually install Knip using your package manager:

npm

npm install -D knip typescript @types/node

pnpm

pnpm add -D knip typescript @types/node

bun

bun add -D knip typescript @types/node

yarn

yarn add -D knip typescript @types/node

Knip uses typescript and @types/node as peer dependencies to increase compatibility with your project. No worries, they’re probably in your node_modules already.

Then add a knip script to your package.json:

package.json

{
  "name": "my-project",
  "scripts": {
    "knip": "knip"
  }
}

Without installation

To run Knip without adding it to your project:

npm

npx knip

pnpm

pnpm dlx knip

bun

bunx knip

In this scenario typescript and @types/node are expected to be installed already.