@knip/mcp 0.0.8 → 0.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knip/mcp",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Knip MCP Server",
   "type": "module",
   "bin": {
@@ -11,8 +11,7 @@
     "./tools": "./src/tools.js"
   },
   "files": [
-    "src",
-    "docs"
+    "src"
   ],
   "keywords": [
     "knip",
@@ -29,7 +28,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.3",
     "zod": "^4.1.11",
-    "knip": "^5.77.0"
+    "knip": "^5.77.1"
   },
   "engines": {
     "node": ">=18.18.0"

package/{docs → src/docs/docs}/blog/for-editors-and-agents.md

@@ -16,7 +16,7 @@ tidy.
 
 Don't forget... Knip it before you ship it!
 
-## VS Code Extension
+## VS Code/Open VSX Extension
 
 This one is for you.
 
@@ -32,6 +32,8 @@ check. We're starting out with [3 key features][4]:
 
 Find [Knip on the VS Code Marketplace][5].
 
+**EDIT:** Or find [Knip on the Open VSX Registry][6].
+
 ## MCP Server
 
 Configuring Knip has always been a major headache to many. No more. Tell your
@@ -39,7 +41,7 @@ coding agent to "configure knip" and it will RTFM so you don't have to. Using a
 newer model like Opus 4.5 or GPT 5.2 results in an optimized `knip.json` file
 and an uncluttered codebase.
 
-The [MCP Server is available][6] separately and built into the VS Code
+The [MCP Server is available][7] separately and built into the VS Code
 Extension.
 
 ## Language Server
@@ -51,25 +53,25 @@ information. Queries like "where is an export imported" or "is this import part
 of a circular dependency" are just scratching the surface here.
 
 Extensions for other IDEs can be built on top. See
-[language-server/README.md][7]
+[language-server/README.md][8]
 
 ## Screenshots
 
 - [Lint Findings][3]
 - [Imports & Exports][4]
-- [Contention][8]
-  - [Circular Dependencies][9]
-  - [Conflicts][10]
-  - [Branching][11]
-- [VS Code Extension Settings][12]
+- [Contention][9]
+  - [Circular Dependencies][10]
+  - [Conflicts][11]
+  - [Branching][12]
+- [VS Code Extension Settings][13]
 
 ### Lint Findings
 
-![Lint Findings][13]
+![Lint Findings][14]
 
 ### Imports & Exports
 
-![hover][14]
+![hover][15]
 
 ### Contention
 
@@ -81,7 +83,7 @@ branched/diamond-shaped import chains.
 
 If an import is part of a circular dependency, Knip will display:
 
-![Circular Dependencies][15]
+![Circular Dependencies][16]
 
 #### Conflicts
 
@@ -89,7 +91,7 @@ TypeScript shows direct conflicts when importing or re-exporting the same named
 export from different files. Except when the problem is more subtle and the
 chain spans more than one file. Knip warns:
 
-![Conflicts][16]
+![Conflicts][17]
 
 #### Branching
 
@@ -97,28 +99,29 @@ Branched or diamond-shaped imports chains indicate unnecessary re-exports and
 complexity. They help to untangle large codebases and shrink or get rid of
 barrel files. Knip warns:
 
-![Branching][17]
+![Branching][18]
 
 ### VS Code Extension Settings
 
-![VS Code Extension Settings][18]
+![VS Code Extension Settings][19]
 
 [1]: https://github.com/webpro-nl/knip/network/dependents
 [2]: https://www.npmjs.com/package/knip
 [3]: #lint-findings
 [4]: #imports--exports
 [5]: https://marketplace.visualstudio.com/items?itemName=webpro.vscode-knip
-[6]: https://www.npmjs.com/package/@knip/mcp
-[7]:
+[6]: https://open-vsx.org/extension/webpro/vscode-knip
+[7]: https://www.npmjs.com/package/@knip/mcp
+[8]:
   https://github.com/webpro-nl/knip/blob/main/packages/language-server/README.md
-[8]: #contention
-[9]: #circular-dependencies
-[10]: #conflicts
-[11]: #branching
-[12]: #vs-code-extension-settings
-[13]: /screenshots/editors-and-agents/diagnostics.webp
-[14]: /screenshots/editors-and-agents/imports-exports.webp
-[15]: /screenshots/editors-and-agents/circular-dependency.webp
-[16]: /screenshots/editors-and-agents/conflict.webp
-[17]: /screenshots/editors-and-agents/branch.webp
-[18]: /screenshots/editors-and-agents/vscode-extension-settings.webp
+[9]: #contention
+[10]: #circular-dependencies
+[11]: #conflicts
+[12]: #branching
+[13]: #vs-code-extension-settings
+[14]: /screenshots/editors-and-agents/diagnostics.webp
+[15]: /screenshots/editors-and-agents/imports-exports.webp
+[16]: /screenshots/editors-and-agents/circular-dependency.webp
+[17]: /screenshots/editors-and-agents/conflict.webp
+[18]: /screenshots/editors-and-agents/branch.webp
+[19]: /screenshots/editors-and-agents/vscode-extension-settings.webp

package/{docs → src/docs}/explanations/plugins.md

@@ -57,7 +57,7 @@ as unlisted. And vice versa, if there are any ESLint plugins listed in
 
 ### Example: Vitest
 
-The second example uses [the Vitest plugin][7]. Here's a minimal example of a
+The second example uses [the Vitest plugin][8]. Here's a minimal example of a
 Vitest configuration file:
 
 ```ts title="vitest.config.ts"
@@ -293,7 +293,7 @@ node --loader tsx scripts/deploy.ts
 playwright test -c playwright.web.config.ts
 ```
 
-Please see [script parser][8] for more details.
+Please see [script parser][9] for more details.
 
 ## Summary
 
@@ -315,4 +315,5 @@ Plugins are configured with two distinct types of files:
 [5]: #command-line-arguments
 [6]: ./entry-files.md
 [7]: ../reference/plugins/eslint.md
-[8]: ../features/script-parser.md
+[8]: ../reference/plugins/vitest.md
+[9]: ../features/script-parser.md

package/{docs → src/docs}/features/integrated-monorepos.md

@@ -49,4 +49,13 @@ In that case, we could configure the ESLint and Cypress plugins like this:
 Adapt the file patterns to your project, and the relevant `config` and `entry`
 files and dependencies should no longer be reported as unused.
 
+## Internal Workspace Dependencies
+
+A note about repositories with multiple `package.json` files and **internal**
+workspace packages: it is recommended to list all dependencies in each consuming
+`package.json`, allowing Knip to do fine-grained reporting of both unused and
+unlisted dependencies.
+
+An alternative is to `ignoreDependencies: ["@internal/*"]`.
+
 [1]: https://nx.dev/getting-started/tutorials/integrated-repo-tutorial

package/src/docs/reference/plugins/angular.md

@@ -0,0 +1,33 @@
+---
+title: Angular
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"@angular/cli"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "angular": {
+    "config": [
+      "angular.json"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [angular plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/angular/index.ts).

package/src/docs/reference/plugins/astro-db.md

@@ -0,0 +1,34 @@
+---
+title: Astro DB
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"@astrojs/db"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "astro-db": {
+    "entry": [
+      "db/config.{js,ts}",
+      "db/seed.{js,ts}"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [astro-db plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/astro-db/index.ts).

package/src/docs/reference/plugins/astro.md

@@ -0,0 +1,43 @@
+---
+title: Astro
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"astro"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "astro": {
+    "config": [
+      "astro.config.{js,cjs,mjs,ts,mts}"
+    ],
+    "entry": [
+      "src/content/config.ts",
+      "src/content.config.ts",
+      "src/pages/**/*.{astro,mdx,js,ts}",
+      "!src/pages/**/_*",
+      "!src/pages/**/_*/**",
+      "src/content/**/*.mdx",
+      "src/middleware.{js,ts}",
+      "src/actions/index.{js,ts}"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [astro plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/astro/index.ts).

package/src/docs/reference/plugins/ava.md

@@ -0,0 +1,46 @@
+---
+title: Ava
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"ava"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "ava": {
+    "config": [
+      "ava.config.{js,cjs,mjs}",
+      "package.json"
+    ],
+    "entry": [
+      "test.{js,cjs,mjs,ts}",
+      "{src,source}/test.{js,cjs,mjs,ts}",
+      "**/__tests__/**/*.{js,cjs,mjs,ts}",
+      "**/*.spec.{js,cjs,mjs,ts}",
+      "**/*.test.{js,cjs,mjs,ts}",
+      "**/test-*.{js,cjs,mjs,ts}",
+      "**/test/**/*.{js,cjs,mjs,ts}",
+      "**/tests/**/*.{js,cjs,mjs,ts}",
+      "!**/__tests__/**/__{helper,fixture}?(s)__/**/*",
+      "!**/test?(s)/**/{helper,fixture}?(s)/**/*"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [ava plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/ava/index.ts).

package/src/docs/reference/plugins/babel.md

@@ -0,0 +1,38 @@
+---
+title: Babel
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if there's a match in `"dependencies"` or `"devDependencies"` in `package.json`:
+
+- `^@babel\/`
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "babel": {
+    "config": [
+      "babel.config.{json,js,cjs,mjs,cts,ts}",
+      ".babelrc.{json,js,cjs,mjs,cts}",
+      ".babelrc",
+      "package.json"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [babel plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/babel/index.ts).

package/src/docs/reference/plugins/biome.md

@@ -0,0 +1,34 @@
+---
+title: Biome
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"@biomejs/biome"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "biome": {
+    "config": [
+      "biome.json",
+      "biome.jsonc"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [biome plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/biome/index.ts).

package/src/docs/reference/plugins/bumpp.md

@@ -0,0 +1,38 @@
+---
+title: bumpp
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"bumpp"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "bumpp": {
+    "entry": [
+      "package.json",
+      ".bumprc",
+      ".config/bumprc",
+      ".bumprc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}",
+      "bump.config.{js,ts,mjs,cjs,mts,cts}",
+      ".config/bumprc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [bumpp plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/bumpp/index.ts).

package/src/docs/reference/plugins/bun.md

@@ -0,0 +1,33 @@
+---
+title: Bun
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"bun"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "bun": {
+    "config": [
+      "package.json"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [bun plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/bun/index.ts).

package/src/docs/reference/plugins/c8.md

@@ -0,0 +1,26 @@
+---
+title: c8
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is always enabled.
+
+## Shell commands
+
+This plugin adds argument parsing for the <code>c8</code>
+binary. Configuration:
+
+```
+args: args2=>args2.filter(arg=>arg!=="check-coverage")
+boolean: ["all", "check-coverage", "clean", "exclude-after-remap", "per-file", "skip-full"]
+fromArgs: (parsed,args2)=>argsFrom(args2,parsed._[0])
+```
+
+The configuration was generated from source code. Also see [Script Parser](../../features/script-parser).
+
+## Generated from source
+
+This page was generated from the [c8 plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/c8/index.ts).

package/src/docs/reference/plugins/capacitor.md

@@ -0,0 +1,35 @@
+---
+title: Capacitor
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if there's a match in `"dependencies"` or `"devDependencies"` in `package.json`:
+
+- `^@capacitor\/`
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "capacitor": {
+    "config": [
+      "capacitor.config.{json,ts}"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [capacitor plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/capacitor/index.ts).

package/src/docs/reference/plugins/changelogen.md

@@ -0,0 +1,38 @@
+---
+title: Changelogen
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"changelogen"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "changelogen": {
+    "entry": [
+      "package.json",
+      ".changelogrc",
+      ".config/changelogrc",
+      ".changelogrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}",
+      "changelog.config.{js,ts,mjs,cjs,mts,cts}",
+      ".config/changelogrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [changelogen plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/changelogen/index.ts).

package/src/docs/reference/plugins/changelogithub.md

@@ -0,0 +1,38 @@
+---
+title: Changelogithub
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"changelogithub"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "changelogithub": {
+    "entry": [
+      "package.json",
+      ".changelogithubrc",
+      ".config/changelogithubrc",
+      ".changelogithubrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}",
+      "changelogithub.config.{js,ts,mjs,cjs,mts,cts}",
+      ".config/changelogithubrc.{json,jsonc,json5,yaml,yml,js,ts,mjs,cjs,mts,cts,toml}"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [changelogithub plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/changelogithub/index.ts).

package/src/docs/reference/plugins/changesets.md

@@ -0,0 +1,33 @@
+---
+title: Changesets
+sidebar:
+  hidden: true
+---
+
+## Enabled
+
+This plugin is enabled if `"@changesets/cli"` is listed in `"dependencies"` or `"devDependencies"` in `package.json`.
+
+## Default configuration
+
+If this plugin is enabled, the following configuration is added automatically:
+
+```json
+{
+  "changesets": {
+    "config": [
+      ".changeset/config.json"
+    ]
+  }
+}
+```
+
+Depending on local configuration, plugins may modify the defaults as shown.
+
+Custom `config` or `entry` options override default values, they are not merged.
+
+See [Plugins](../../explanations/plugins) for more details about plugins and their `entry` and `config` options.
+
+## Generated from source
+
+This page was generated from the [changesets plugin source code](https://github.com/webpro-nl/knip/blob/main/packages/knip/src/plugins/changesets/index.ts).