@knip/mcp 0.0.15 → 0.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knip/mcp",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "Knip MCP Server",
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
     "zod": "^4.1.11",
-    "knip": "^5.80.1"
+    "knip": "^5.81.0"
   },
   "engines": {
     "node": ">=18.18.0"

package/src/docs/docs/features/monorepos-and-workspaces.md

@@ -100,16 +100,31 @@ The following options are available inside workspace configurations:
 Use `--debug` for verbose output and see the workspaces Knip includes, their
 configurations, enabled plugins, glob options and resolved files.
 
-## Lint a single workspace
+## Filter workspaces
 
-Use the `--workspace` (or `-W`) argument to focus on a single workspace (and let
-Knip run faster). Example:
+Use the `--workspace` (or `-W`) argument to select one or more workspaces:
 
 ```sh
 knip --workspace packages/my-lib
 ```
 
-This will include the target workspace, but also ancestor and dependent
+The filter supports multiple formats:
+
+```sh
+knip --workspace @myorg/my-lib     # Package name
+knip --workspace '@myorg/*'        # Package name glob
+knip --workspace packages/my-lib   # Directory path
+knip --workspace './apps/*'        # Directory glob
+```
+
+Combine selectors to include or exclude workspaces:
+
+```sh
+knip --workspace @myorg/* --workspace '!@myorg/legacy'
+knip --workspace './apps/*' --workspace '@shared/utils'
+```
+
+This will include the target workspace(s), but also ancestor and dependent
 workspaces. For two reasons:
 
 - Ancestor workspaces may list dependencies in `package.json` the linted

package/src/docs/docs/guides/troubleshooting.md

@@ -90,7 +90,7 @@ a regex that works too:
 
 <img src="/screenshots/trace-dependency.png" alt="trace dependency" class="mw500" />
 
-Use [--workspace \[dir\]][8] to filter accordingly.
+Use [--workspace \[filter\]][8] to filter accordingly.
 
 #### Legend
 
@@ -124,7 +124,7 @@ to [open an issue on GitHub][14].
 [5]: ../guides/handling-issues.mdx
 [6]: ./issue-reproduction.md
 [7]: ../reference/known-issues.md
-[8]: ../reference/cli.md#--workspace-dir
+[8]: ../reference/cli.md#--workspace-filter
 [9]: ../explanations/entry-files.md
 [10]: ../explanations/plugins.md
 [11]: ../features/production-mode.md

package/src/docs/docs/overview/features.md

@@ -36,7 +36,7 @@ Also see [related tooling][2].
 | [Strict mode][23]            | Use `--strict` to isolate workspaces and consider only `dependencies` |
 | [Trace][24]                  | Trace exports to find where they are used                             |
 | [Watch mode][25]             | Use `--watch` for live updates of unused files and exports            |
-| [Workspace][26]              | Use `--workspace` to lint a single workspace in a monorepo            |
+| [Workspace][26]              | Use `--workspace` to filter workspaces in a monorepo                  |
 
 [1]: ../reference/issue-types.md
 [2]: ../reference/related-tooling.md

package/src/docs/docs/reference/cli.md

@@ -23,152 +23,6 @@ Shortcut: `-n`
 Don't show dynamic progress updates. Progress is automatically disabled in CI
 environments.
 
-### `knip-bun`
-
-Run Knip using the Bun runtime (instead of Node.js + jiti).
-
-```shell
-knip-bun
-```
-
-This is equal to `bunx --bun knip`
-
-Requires [Bun][1] to be installed. Also see [known issues][2] for the type of
-issues this might help with.
-
-### NO_COLOR
-
-The default reporters use the [NO_COLOR][3] friendly [picocolors][4]:
-
-```sh
-NO_COLOR=1 knip
-```
-
-## Troubleshooting
-
-### `--debug`
-
-Shortcut: `-d`
-
-Show debug output.
-
-### `--memory`
-
-```txt frame=terminal
-knip --memory
-
-(results)
-
- # heapUsed  heapTotal  freemem
--- --------  ---------  -------
- 0    42.09      70.91  2251.00
- 1   927.04    1042.58  1166.47
- 2   973.29    1047.33  1160.92
- 3   971.54    1079.83  1121.66
- 4   997.80    1080.33  1120.34
- 5  1001.88    1098.08  1100.72
- 6  1038.69    1116.58  1100.72
- 7  1082.12    1166.33  1100.72
- 8  1145.46    1224.50  1100.72
- 9  1115.82    1240.25  1100.72
-10  1182.35    1249.75   973.05
-11   637.32    1029.17   943.63
-12   674.30    1029.33   943.39
-13   682.24    1029.33   941.63
-14   707.70    1029.33   937.48
-
-Total running time: 4.3s
-```
-
-Can be used with [--isolate-workspaces][5] to see the difference in garbage
-collection during the process.
-
-### `--memory-realtime`
-
-Use this if Knip crashes to still see memory usage info over time:
-
-```txt frame=terminal
-knip --memory-realtime
-
-#  heapUsed  heapTotal  freemem
--  --------  ---------  -------
-0     42.09      70.91  2251.00
-1    927.04    1042.58  1166.47
-...mem info keeps being logged...
-
-(results)
-```
-
-### `--performance`
-
-Use this flag to get the count and execution time of potentially expensive
-functions in a table. Example:
-
-```txt frame=terminal
-$ knip --performance
-
-(results)
-
-Name                           size  min       max       median    sum
------------------------------  ----  --------  --------  --------  --------
-findReferences                  648     84.98   7698.61     96.41  70941.70
-createProgram                     2   6295.84   7064.68   6680.26  13360.52
-glob                              6      0.05    995.78    513.82   3150.87
-findESLintDependencies            2      0.01     74.41     37.21     74.41
-findGithubActionsDependencies     6      0.16     12.71      0.65     23.45
-findBabelDependencies             2      0.00     38.75     19.37     38.75
-...
-
-Total running time: 5s
-```
-
-- `name`: the internal Knip function name
-- `size`: number of function invocations
-- `min`: the fastest invocation
-- `max`: the slowest invocation
-- `median`: the median invocation
-- `sum` the accumulated time of all invocations
-
-This is not yet available in Bun, since it does not support
-`performance.timerify` ([GitHub issue][6]).
-
-### `--performance-fn`
-
-Limit the output of `--performance` to a single function to minimize the
-overhead of the `timerify` Node.js built-in and focus on that function alone:
-
-```txt frame=terminal
-$ knip --performance-fn resolveSync
-
-(results)
-
-Name         size   min   max   median   sum
------------  -----  ----  ----  ------  ------
-resolveSync  66176  0.00  5.69    0.00  204.85
-
-Total running time: 12.9s
-```
-
-### `--trace`
-
-Trace exports to see where they are imported.
-
-Also see [Trace][7].
-
-### `--trace-dependency [name]`
-
-Trace package or binary name to see where it's referenced. Implies [--trace][8].
-
-### `--trace-export [name]`
-
-Trace export name to see where it's imported. Implies [--trace][8].
-
-### `--trace-file [path]`
-
-Trace file to see where its exports are imported. Implies [--trace][8].
-
-## Configuration
-
 ### `--config [file]`
 
 Use an alternative path for the configuration file. Default locations:
@@ -183,6 +37,10 @@ Use an alternative path for the configuration file. Default locations:
 
 Shortcut: `-c`
 
+### `--use-tsconfig-files`
+
+Use `tsconfig.json` to define project files (override `project` patterns).
+
 ### `--tsConfig [file]`
 
 Shortcut: `-t`
@@ -193,22 +51,42 @@ Using `-t jsconfig.json` is also supported.
 
 Default location: `tsconfig.json`
 
-### `--workspace [dir]`
+### `knip-bun`
 
-[Lint a single workspace][9] including its ancestor and dependent workspaces.
-The default behavior is to lint all configured workspaces.
+Run Knip using the Bun runtime (instead of Node.js + jiti).
 
-Shortcut: `-W`
+```shell
+knip-bun
+```
 
-### `--directory [dir]`
+This is equal to `bunx --bun knip`
 
-Default: `cwd` (current directory)
+Requires [Bun][1] to be installed. Also see [known issues][2] for the type of
+issues this might help with.
 
-Run the process from a different directory.
+### NO_COLOR
 
-### `--no-gitignore`
+The built-in reporters use the [NO_COLOR][3] friendly [picocolors][4]:
 
-Ignore `.gitignore` files.
+```sh
+NO_COLOR=1 knip
+```
+
+## Mode
+
+### `--cache`
+
+Enable caching.
+
+Consecutive runs are 10-40% faster as the results of file analysis (AST
+traversal) are cached. Conservative. Cache strategy based on file meta data
+(modification time + file size).
+
+### `--cache-location`
+
+Provide alternative cache location.
+
+Default location: `./node_modules/.cache/knip`
 
 ### `--include-entry-exports`
 
@@ -219,7 +97,7 @@ files when reporting unused exports:
 knip --include-entry-exports
 ```
 
-Also see [includeEntryExports][10].
+Also see [includeEntryExports][5].
 
 ### `--include-libs`
 
@@ -230,16 +108,18 @@ Getting false positives for exports consumed by external libraries? Try the
 knip --include-libs
 ```
 
-Also see [external libs][11].
+Also see [external libs][6].
 
 ### `--isolate-workspaces`
 
-By default, Knip optimizes performance using [workspace sharing][12] to existing
+By default, Knip optimizes performance using [workspace sharing][7] to existing
 TypeScript programs, based on the compatibility of their `compilerOptions`. This
 flag disables this behavior and creates one program per workspace, which is
 slower but memory usage is spread more evenly over time.
 
-## Modes
+### `--no-gitignore`
+
+Ignore `.gitignore` files.
 
 ### `--production`
 
@@ -251,32 +131,14 @@ Lint only production source files. This excludes:
   - Storybook stories
 - `devDependencies` from `package.json`
 
-Read more at [Production Mode][13].
+Read more at [Production Mode][8].
 
 ### `--strict`
 
 Isolate workspaces and consider only direct dependencies. Implies [production
-mode][14].
+mode][9].
 
-Read more at [Production Mode][13].
-
-### `--fix`
-
-Read more at [auto-fix][15].
-
-### `--cache`
-
-Enable caching.
-
-Consecutive runs are 10-40% faster as the results of file analysis (AST
-traversal) are cached. Conservative. Cache strategy based on file meta data
-(modification time + file size).
-
-### `--cache-location`
-
-Provide alternative cache location.
-
-Default location: `./node_modules/.cache/knip`
+Read more at [Production Mode][8].
 
 ### `--watch`
 
@@ -286,23 +148,22 @@ added or deleted.
 Watch mode focuses on imports and exports in source files. During watch mode,
 changes in `package.json` or `node_modules` may not cause an updated report.
 
-## Filters
+## Scope
 
-Available [issue types][16] when filtering output using `--include` or
-`--exclude`:
+### `--workspace [filter]`
 
-- `files`
-- `dependencies`
-- `optionalPeerDependencies`
-- `unlisted`
-- `unresolved`
-- `exports`
-- `nsExports`
-- `classMembers`
-- `types`
-- `nsTypes`
-- `enumMembers`
-- `duplicates`
+Select one or multiple workspaces (including its ancestor and dependent
+workspaces). The default behavior is to lint all configured workspaces.
+
+Shortcut: `-W`
+
+See [filter workspaces][10] for more details and examples.
+
+### `--directory [dir]`
+
+Default: `cwd` (current directory)
+
+Run the process from a different directory.
 
 ### `--exclude`
 
@@ -326,12 +187,28 @@ knip --include files,dependencies
 knip --include files --include dependencies
 ```
 
+Available [issue types][11] when filtering output using `--include` or
+`--exclude`:
+
+- `files`
+- `dependencies`
+- `unlisted`
+- `unresolved`
+- `exports`
+- `nsExports`
+- `classMembers`
+- `types`
+- `nsTypes`
+- `enumMembers`
+- `duplicates`
+- `catalog`
+
 ### `--dependencies`
 
 Shortcut to include all types of dependency issues:
 
 ```sh
---include dependencies,optionalPeerDependencies,unlisted,binaries,unresolved
+--include dependencies,unlisted,binaries,unresolved,catalog
 ```
 
 ### `--exports`
@@ -342,9 +219,13 @@ Shortcut to include all types of export issues:
 --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates
 ```
 
-### `--experimental-tags`
+### `--files`
 
-Deprecated. Use [--tags][17] instead.
+Shortcut to include file issues:
+
+```sh
+--include files
+```
 
 ### `--tags`
 
@@ -380,7 +261,51 @@ notation below is valid and will report only exports tagged `@lintignore` or
 knip --tags @lintignore --tags @internal
 ```
 
-## Reporters & Preprocessors
+## Fix
+
+### `--fix`
+
+Read more at [auto-fix][12].
+
+### `--fix-type`
+
+Fix only issues of type, can be comma-separated or repeated.
+
+More info about fixable types at [issue types][11]
+
+### `--allow-remove-files`
+
+Allow Knip to remove files (with `--fix`).
+
+### `--format`
+
+Format modified files after `--fix` using the local formatter.
+
+## Output
+
+### `--preprocessor [preprocessor]`
+
+Preprocess the results before providing it to the [reporter(s)][13].
+
+Can be repeated. Examples:
+
+```sh
+knip --preprocessor ./my-preprocessor.ts
+```
+
+```sh
+knip --preprocessor preprocessor-package
+```
+
+Also see [Reporters & Preprocessors][14].
+
+### `--preprocessor-options [json]`
+
+Pass extra options to the preprocessor as JSON string.
+
+```sh
+knip --preprocessor ./preproc.ts --preprocessor-options '{"key":"value"}'
+```
 
 ### `--reporter [reporter]`
 
@@ -390,7 +315,10 @@ Available reporters:
 - `compact`
 - `codeowners`
 - `json`
+- `codeclimate`
 - `markdown`
+- `disclosure`
+- `github-actions`
 
 Can be repeated. Example:
 
@@ -398,12 +326,11 @@ Can be repeated. Example:
 knip --reporter compact
 ```
 
-Also see [Reporters & Preprocessors][18].
+Also see [Reporters & Preprocessors][14].
 
 ### `--reporter-options [json]`
 
-Pass extra options to the preprocessor (as JSON string, see --reporter-options
-example)
+Pass extra options to the reporter (as JSON string):
 
 Example:
 
@@ -411,75 +338,174 @@ Example:
 knip --reporter codeowners --reporter-options '{"path":".github/CODEOWNERS"}'
 ```
 
-### `--preprocessor [preprocessor]`
+### `--no-config-hints`
 
-Preprocess the results before providing it to the reporters.
+Suppress configuration hints.
 
-Can be repeated. Examples:
+### `--treat-config-hints-as-errors`
 
-```sh
-knip --preprocessor ./my-preprocessor.ts
-```
+Exit with non-zero exit code (`1`) if there are any configuration hints.
 
-```sh
-knip --preprocessor preprocessor-package
-```
+### `--max-issues`
 
-### `--preprocessor-options [json]`
+Maximum number of issues before non-zero exit code. Default: `0`
 
-Pass extra options to the preprocessor as JSON string.
+### `--max-show-issues`
 
-```sh
-knip --preprocessor ./preproc.ts --preprocessor-options '{"key":"value"}'
-```
+Maximum number of issues per type to display (does not affect exit code).
 
-Also see [Reporters & Preprocessors][18].
+### `--no-exit-code`
 
-## Exit code
+Always exit with code zero (`0`), even when there are lint issues.
 
 The default exit codes:
 
 | Code | Description                                                      |
 | :--: | :--------------------------------------------------------------- |
 | `0`  | Knip ran successfully, no lint issues                            |
-| `1`  | Knip ran successfully, but there is at least one lint issues     |
+| `1`  | Knip ran successfully, but there is at least one lint issue      |
 | `2`  | Knip did not run successfully due to bad input or internal error |
 
-### `--no-exit-code`
+## Troubleshooting
 
-Always exit with code zero (`0`), even when there are lint issues.
+### `--debug`
 
-### `--max-issues`
+Shortcut: `-d`
 
-Maximum number of issues before non-zero exit code. Default: `0`
+Show [debug output][15].
 
-### `--max-show-issues`
+### `--memory`
 
-Maximum number of issues per type to display (does not affect exit code).
+```txt frame=terminal
+knip --memory
 
-### `--no-config-hints`
+(results)
 
-Suppress configuration hints.
+ # heapUsed  heapTotal  freemem
+-- --------  ---------  -------
+ 0    42.09      70.91  2251.00
+ 1   927.04    1042.58  1166.47
+ 2   973.29    1047.33  1160.92
+ 3   971.54    1079.83  1121.66
+ 4   997.80    1080.33  1120.34
+ 5  1001.88    1098.08  1100.72
+ 6  1038.69    1116.58  1100.72
+ 7  1082.12    1166.33  1100.72
+ 8  1145.46    1224.50  1100.72
+ 9  1115.82    1240.25  1100.72
+10  1182.35    1249.75   973.05
+11   637.32    1029.17   943.63
+12   674.30    1029.33   943.39
+13   682.24    1029.33   941.63
+14   707.70    1029.33   937.48
 
-### `--treat-config-hints-as-errors`
+Total running time: 4.3s
+```
+
+Can be used with [--isolate-workspaces][16] to see the difference in garbage
+collection during the process.
+
+### `--memory-realtime`
+
+Use this if Knip crashes to still see memory usage info over time:
+
+```txt frame=terminal
+knip --memory-realtime
+
+#  heapUsed  heapTotal  freemem
+-  --------  ---------  -------
+0     42.09      70.91  2251.00
+1    927.04    1042.58  1166.47
+...mem info keeps being logged...
+
+(results)
+```
+
+### `--performance`
+
+Use this flag to get the count and execution time of potentially expensive
+functions in a table. Example:
+
+```txt frame=terminal
+$ knip --performance
+
+(results)
+
+Name                           size  min       max       median    sum
+-----------------------------  ----  --------  --------  --------  --------
+findReferences                  648     84.98   7698.61     96.41  70941.70
+createProgram                     2   6295.84   7064.68   6680.26  13360.52
+glob                              6      0.05    995.78    513.82   3150.87
+findESLintDependencies            2      0.01     74.41     37.21     74.41
+findGithubActionsDependencies     6      0.16     12.71      0.65     23.45
+findBabelDependencies             2      0.00     38.75     19.37     38.75
+...
+
+Total running time: 5s
+```
+
+- `name`: the internal Knip function name
+- `size`: number of function invocations
+- `min`: the fastest invocation
+- `max`: the slowest invocation
+- `median`: the median invocation
+- `sum` the accumulated time of all invocations
+
+This is not yet available in Bun, since it does not support
+`performance.timerify` ([GitHub issue][17]).
+
+### `--performance-fn`
+
+Limit the output of `--performance` to a single function to minimize the
+overhead of the `timerify` Node.js built-in and focus on that function alone:
+
+```txt frame=terminal
+$ knip --performance-fn resolveSync
+
+(results)
+
+Name         size   min   max   median   sum
+-----------  -----  ----  ----  ------  ------
+resolveSync  66176  0.00  5.69    0.00  204.85
+
+Total running time: 12.9s
+```
+
+### `--trace`
+
+Trace exports to see where they are imported.
+
+Also see [Trace][18].
+
+### `--trace-dependency [name]`
+
+Trace package or binary name to see where it's referenced. Implies
+[--trace][19].
+
+### `--trace-export [name]`
+
+Trace export name to see where it's imported. Implies [--trace][19].
+
+### `--trace-file [path]`
 
-Exit with non-zero code (`1`) if there are any configuration hints.
+Trace file to see where its exports are imported. Implies [--trace][19].
 
 [1]: https://bun.sh
 [2]: ../reference/known-issues.md
 [3]: https://no-color.org/
 [4]: https://www.npmjs.com/package/picocolors
-[5]: #--isolate-workspaces
-[6]: https://github.com/oven-sh/bun/issues/9271
-[7]: ../guides/troubleshooting.md#trace
-[8]: #--trace
-[9]: ../features/monorepos-and-workspaces.md#lint-a-single-workspace
-[10]: ./configuration.md#includeentryexports
-[11]: ../guides/handling-issues.mdx#external-libraries
-[12]: ../guides/performance.md#workspace-sharing
-[13]: ../features/production-mode.md
-[14]: #--production
-[15]: ../features/auto-fix.mdx
-[16]: ./issue-types.md
-[17]: #--tags
-[18]: ../features/reporters.md
+[5]: ./configuration.md#includeentryexports
+[6]: ../guides/handling-issues.mdx#external-libraries
+[7]: ../guides/performance.md#workspace-sharing
+[8]: ../features/production-mode.md
+[9]: #--production
+[10]: ../features/monorepos-and-workspaces.md#filter-workspaces
+[11]: ./issue-types.md
+[12]: ../features/auto-fix.mdx
+[13]: #--reporter-reporter
+[14]: ../features/reporters.md
+[15]: ../guides/troubleshooting.md#debug
+[16]: #--isolate-workspaces
+[17]: https://github.com/oven-sh/bun/issues/9271
+[18]: ../guides/troubleshooting.md#trace
+[19]: #--trace