knip 6.24.0 → 6.26.0

package/dist/typescript/get-imports-and-exports.js

@@ -24,6 +24,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
     const aliasedExports = new Map();
     const specifierExportNames = new Set();
     const scripts = new Set();
+    const importGlobs = [];
     const importAliases = new Map();
     const addImportAlias = (aliasName, id, importFilePath) => {
         const aliases = importAliases.get(aliasName);
@@ -58,6 +59,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
             line: opts.line,
             col: opts.col,
             isTypeOnly: isDts || !!(modifiers & IMPORT_FLAGS.TYPE_ONLY),
+            modifiers,
         });
         const file = internal.get(importFilePath);
         const importMaps = file ?? createImports();
@@ -93,6 +95,10 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
         if (!specifier || isBuiltin(specifier))
             return;
         const module = preResolvedModule ?? resolveModule(specifier, filePath);
+        if (modifiers & IMPORT_FLAGS.AUGMENT &&
+            (!module || module.isExternalLibraryImport || isInNodeModules(module.resolvedFileName))) {
+            return;
+        }
         if (module) {
             const resolvedFileName = module.resolvedFileName;
             if (resolvedFileName) {
@@ -134,6 +140,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
                         line,
                         col,
                         isTypeOnly: isDts || !!(modifiers & IMPORT_FLAGS.TYPE_ONLY),
+                        modifiers,
                     });
                 }
             }
@@ -158,6 +165,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
                     line,
                     col,
                     isTypeOnly: isDts || !!(modifiers & IMPORT_FLAGS.TYPE_ONLY),
+                    modifiers,
                 });
             }
         }
@@ -266,6 +274,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
         pluginCtx.sourceText = sourceText;
         pluginCtx.addScript = (s) => scripts.add(s);
         pluginCtx.addImport = (spec, pos, mod) => addImport(spec, undefined, undefined, undefined, pos, mod);
+        pluginCtx.addImportGlob = (patterns, opts) => importGlobs.push({ patterns, base: opts?.base, filter: opts?.filter });
         pluginCtx.markExportRegistered = (name) => registeredCustomElements.add(name);
     }
     const localRefs = _walkAST(result.program, sourceText, filePath, {
@@ -314,6 +323,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
         exports,
         duplicates: [...aliasedExports.values()],
         scripts,
+        importGlobs,
         importedBy: undefined,
         internalImportCache: undefined,
     };

package/dist/typescript/glob-imports.d.ts

@@ -0,0 +1,3 @@
+import type { ImportGlob } from '../types/module-graph.ts';
+import type { ResolveGlobPattern } from './resolve-module-names.ts';
+export declare function resolveImportGlobs(items: ImportGlob[], containingFile: string, resolveGlobPattern: ResolveGlobPattern, workspaceRoot: string): string[];

package/dist/typescript/glob-imports.js

@@ -0,0 +1,49 @@
+import { existsSync } from 'node:fs';
+import { _syncGlob } from '../util/glob.js';
+import { dirname, isAbsolute, join, toRelative } from '../util/path.js';
+function resolveBaseDir(base, dir, resolveGlobPattern) {
+    if (base.startsWith('.'))
+        return join(dir, base);
+    if (isAbsolute(base))
+        return base;
+    for (const resolved of resolveGlobPattern(base, dir)) {
+        if (resolved !== base && existsSync(resolved))
+            return resolved;
+    }
+    return undefined;
+}
+export function resolveImportGlobs(items, containingFile, resolveGlobPattern, workspaceRoot) {
+    const filePaths = [];
+    const dir = dirname(containingFile);
+    for (const { patterns, base, filter } of items) {
+        if (base !== undefined) {
+            const cwd = resolveBaseDir(base, dir, resolveGlobPattern);
+            if (!cwd)
+                continue;
+            for (const filePath of _syncGlob({ patterns, cwd })) {
+                if (!filter || filter.test(`./${toRelative(filePath, cwd)}`))
+                    filePaths.push(filePath);
+            }
+        }
+        else {
+            const resolved = [];
+            for (const pattern of patterns) {
+                const isNegated = pattern[0] === '!';
+                const specifier = isNegated ? pattern.slice(1) : pattern;
+                if (specifier[0] === '/') {
+                    const rooted = join(workspaceRoot, specifier);
+                    resolved.push(isNegated ? `!${rooted}` : rooted);
+                }
+                else {
+                    for (const p of resolveGlobPattern(pattern, dir))
+                        resolved.push(p);
+                }
+            }
+            if (resolved.length === 0)
+                continue;
+            for (const filePath of _syncGlob({ patterns: resolved, cwd: dir }))
+                filePaths.push(filePath);
+        }
+    }
+    return filePaths;
+}

package/dist/typescript/resolve-module-names.d.ts

@@ -9,6 +9,8 @@ type ScopedRootDirs = Array<{
     rootDirs: string[];
 }>;
 export declare function clearModuleResolutionCaches(): void;
+export type ResolveGlobPattern = (pattern: string, dir: string) => string[];
+export declare function createGlobAliasResolver(scopedPaths: ScopedPaths | undefined): ResolveGlobPattern;
 export declare function createCustomModuleResolver(compilerOptions: {
     scopedPaths?: ScopedPaths;
     scopedRootDirs?: ScopedRootDirs;

package/dist/typescript/resolve-module-names.js

@@ -3,7 +3,7 @@ import { isBuiltin } from 'node:module';
 import { DEFAULT_EXTENSIONS, DTS_EXTENSIONS } from '../constants.js';
 import { sanitizeSpecifier } from '../util/modules.js';
 import { timerify } from '../util/Performance.js';
-import { dirname, extname, isAbsolute, isInNodeModules, join } from '../util/path.js';
+import { dirname, extname, isAbsolute, isInNodeModules, join, toPosix } from '../util/path.js';
 import { _createSyncModuleResolver, _resolveModuleSync } from '../util/resolve.js';
 function pickStringTarget(value) {
     if (typeof value === 'string')
@@ -56,6 +56,40 @@ function compileRootDirs(scopedRootDirs) {
     scoped.sort((a, b) => b.scope.length - a.scope.length);
     return scoped;
 }
+export function createGlobAliasResolver(scopedPaths) {
+    const mappings = compilePathMappings(scopedPaths);
+    return (pattern, dir) => {
+        if (!mappings)
+            return [pattern];
+        const isNegated = pattern[0] === '!';
+        const specifier = isNegated ? pattern.slice(1) : pattern;
+        let best;
+        for (const mapping of mappings) {
+            const { prefix, wildcard, scope } = mapping;
+            if (dir !== scope && !dir.startsWith(`${scope}/`))
+                continue;
+            const matches = wildcard
+                ? specifier.startsWith(prefix)
+                : specifier === prefix || specifier.startsWith(`${prefix}/`);
+            if (!matches)
+                continue;
+            if (!best ||
+                scope.length > best.scope.length ||
+                (scope.length === best.scope.length && prefix.length > best.prefix.length))
+                best = mapping;
+        }
+        if (!best)
+            return [pattern];
+        const captured = specifier.slice(best.prefix.length);
+        const resolved = [];
+        for (const value of best.values) {
+            const starIdx = value.indexOf('*');
+            const mapped = toPosix(starIdx >= 0 ? value.slice(0, starIdx) + captured + value.slice(starIdx + 1) : value + captured);
+            resolved.push(isNegated ? `!${mapped}` : mapped);
+        }
+        return resolved;
+    };
+}
 export function createCustomModuleResolver(compilerOptions, customCompilerExtensions, toSourceFilePath, findWorkspaceManifestImports, tsConfigFile) {
     const customCompilerExtensionsSet = new Set(customCompilerExtensions);
     const hasCustomExts = customCompilerExtensionsSet.size > 0;

package/dist/typescript/visitors/calls.js

@@ -1,6 +1,6 @@
 import { IMPORT_FLAGS, OPAQUE } from '../../constants.js';
 import { addValue } from '../../util/module-graph.js';
-import { getSafeScriptFromArgs, getStringValue, isStringLiteral } from '../ast-nodes.js';
+import { getSafeScriptFromArgs, getScriptFromArg, getStringValue, isStringLiteral } from '../ast-nodes.js';
 import { isShadowed } from './walk.js';
 function getRegisteredCustomElement(node, s) {
     const callee = node.callee;
@@ -162,11 +162,9 @@ export function handleCallExpression(node, s) {
         if (method) {
             const arg = node.arguments[0];
             if (CHILD_PROCESS_COMMAND_METHODS.has(method)) {
-                if (isStringLiteral(arg)) {
-                    const command = getStringValue(arg);
-                    if (command)
-                        s.scripts.add(command);
-                }
+                const command = getScriptFromArg(arg);
+                if (command)
+                    s.scripts.add(command);
                 return;
             }
             if (CHILD_PROCESS_FILE_METHODS.has(method)) {

package/dist/typescript/visitors/imports.js

@@ -26,16 +26,16 @@ export function handleVariableDeclarator(node, s) {
                             : undefined;
                     const localName = prop.value?.type === 'Identifier' ? prop.value.name : importedName;
                     const alias = localName !== importedName ? localName : undefined;
-                    s.addImport(specifier, importedName, alias, undefined, prop.key?.start ?? prop.start, IMPORT_FLAGS.NONE);
+                    s.addImport(specifier, importedName, alias, undefined, prop.key?.start ?? prop.start, IMPORT_FLAGS.DYNAMIC);
                 }
                 else if (prop.type === 'RestElement' && prop.argument?.type === 'Identifier') {
-                    s.addImport(specifier, IMPORT_STAR, prop.argument.name, undefined, prop.start, IMPORT_FLAGS.NONE);
+                    s.addImport(specifier, IMPORT_STAR, prop.argument.name, undefined, prop.start, IMPORT_FLAGS.DYNAMIC);
                 }
             }
         }
         else if (node.id.type === 'Identifier') {
             if (init.type === 'AwaitExpression') {
-                s.addImport(specifier, 'default', node.id.name, undefined, importExpr.source.start, IMPORT_FLAGS.NONE);
+                s.addImport(specifier, 'default', node.id.name, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC);
                 const resolved = s.resolveModule(specifier, s.filePath);
                 if (resolved && !resolved.isExternalLibraryImport && !isInNodeModules(resolved.resolvedFileName)) {
                     s.localImportMap.set(node.id.name, {
@@ -47,11 +47,11 @@ export function handleVariableDeclarator(node, s) {
                 }
             }
             else {
-                s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.OPAQUE);
+                s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
             }
         }
         else {
-            s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.OPAQUE);
+            s.addImport(specifier, undefined, undefined, undefined, importExpr.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
         }
         return;
     }
@@ -117,10 +117,10 @@ export function handleVariableDeclarator(node, s) {
                     }
                 }
                 else if (binding?.type === 'Identifier') {
-                    s.addImport(specifier, 'default', binding.name, undefined, imp.source.start, IMPORT_FLAGS.NONE);
+                    s.addImport(specifier, 'default', binding.name, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC);
                 }
                 else {
-                    s.addImport(specifier, undefined, undefined, undefined, imp.source.start, IMPORT_FLAGS.SIDE_EFFECTS);
+                    s.addImport(specifier, undefined, undefined, undefined, imp.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.SIDE_EFFECTS);
                 }
             }
         }
@@ -257,6 +257,6 @@ export function handleImportExpression(node, s) {
         return;
     const specifier = getStringValue(node.source);
     if (specifier) {
-        s.addImport(specifier, undefined, undefined, undefined, node.source.start, IMPORT_FLAGS.OPAQUE);
+        s.addImport(specifier, undefined, undefined, undefined, node.source.start, IMPORT_FLAGS.DYNAMIC | IMPORT_FLAGS.OPAQUE);
     }
 }

package/dist/typescript/visitors/script-visitors.js

@@ -1,12 +1,12 @@
+import { getScriptFromTemplate } from '../ast-nodes.js';
 export function createBunShellVisitor(ctx) {
     return {
         TaggedTemplateExpression(node) {
             const tag = node.tag;
             if (tag.type === 'Identifier' && tag.name === '$') {
-                for (const q of node.quasi.quasis) {
-                    if (q.value.raw)
-                        ctx.addScript(q.value.raw);
-                }
+                const script = getScriptFromTemplate(node.quasi);
+                if (script)
+                    ctx.addScript(script);
             }
         },
     };

package/dist/typescript/visitors/walk.js

@@ -213,9 +213,8 @@ const coreVisitorObject = {
         state.nsRanges.push([node.start, node.end]);
         if (node.kind !== 'global' && isStringLiteral(node.id)) {
             const specifier = getStringValue(node.id);
-            if (specifier.startsWith('.'))
-                for (const name of collectAugmentationRefs(node))
-                    state.addImport(specifier, name, undefined, undefined, node.id.start, IMPORT_FLAGS.TYPE_ONLY);
+            for (const name of collectAugmentationRefs(node))
+                state.addImport(specifier, name, undefined, undefined, node.id.start, IMPORT_FLAGS.TYPE_ONLY | IMPORT_FLAGS.AUGMENT);
         }
     },
     ClassDeclaration(node) {

package/dist/util/cli-arguments.d.ts

@@ -1,9 +1,10 @@
-export declare const helpText = "\u2702\uFE0F  Find unused dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -h, --help                   Print this help text\n  -V, --version                Print version\n  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]          Configuration file path\n                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n      --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)\n\nMode\n      --cache                  Enable caching\n      --cache-location         Change cache location (default: node_modules/.cache/knip)\n      --include-entry-exports  Include entry files when reporting unused exports\n      --no-gitignore           Don't respect .gitignore\n  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)\n  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -w, --watch                  Watch mode\n\nScope\n  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)\n  -D, --directory [dir]        Run process from a different directory (default: cwd)\n      --include                Report only provided issue type(s), can be comma-separated or repeated (1)\n      --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog\n      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --tags                   Include or exclude tagged exports\n\nFix\n  -f, --fix                    Fix issues (modifies files in your repo)\n      --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n      --allow-remove-files     Allow Knip to remove files (with --fix)\n  -F, --format                 Format modified files after --fix using the local formatter\n\nOutput\n      --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n      --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n      --reporter               Select reporter (default: symbols), can be repeated (3)\n      --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n      --no-config-hints        Suppress configuration hints\n      --no-tag-hints           Suppress tag hints\n      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints\n      --treat-tag-hints-as-errors      Exit with non-zero code (1) if there are any tag hints\n      --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n      --max-show-issues        Maximum number of issues to display per type\n      --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug                  Show debug output\n      --memory                 Measure memory usage and display data table\n      --memory-realtime        Log memory usage in realtime\n      --performance            Measure count and running time of key functions and display stats table\n      --performance-fn [name]  Measure only function [name]\n  -u, --duration               Print total running time (zero overhead, no instrumentation)\n      --trace                  Show trace output\n      --trace-dependency [name]  Show files that import the named dependency\n      --trace-export [name]    Show trace output for named export(s)\n      --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, json, codeclimate, markdown, disclosure, github-actions\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
+export declare const helpText = "\u2702\uFE0F  Find unused dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -h, --help                   Print this help text\n  -V, --version                Print version\n  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]          Configuration file path\n                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n      --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)\n\nMode\n      --cache                  Enable caching\n      --cache-location         Change cache location (default: node_modules/.cache/knip)\n      --include-entry-exports  Include entry files when reporting unused exports\n      --no-gitignore           Don't respect .gitignore\n  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)\n  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -w, --watch                  Watch mode\n\nScope\n  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)\n  -D, --directory [dir]        Run process from a different directory (default: cwd)\n      --include                Include provided issue type(s), can be comma-separated or repeated (1)\n      --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog\n      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --cycles                 Shortcut for --include cycles (circular dependencies)\n      --tags                   Include or exclude tagged exports\n\nFix\n  -f, --fix                    Fix issues (modifies files in your repo)\n      --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n      --allow-remove-files     Allow Knip to remove files (with --fix)\n  -F, --format                 Format modified files after --fix using the local formatter\n\nOutput\n      --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n      --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n      --reporter               Select reporter (default: symbols), can be repeated (3)\n      --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n      --no-config-hints        Suppress configuration hints\n      --no-tag-hints           Suppress tag hints\n      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints\n      --treat-tag-hints-as-errors      Exit with non-zero code (1) if there are any tag hints\n      --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n      --max-show-issues        Maximum number of issues to display per type\n      --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug                  Show debug output\n      --memory                 Measure memory usage and display data table\n      --memory-realtime        Log memory usage in realtime\n      --performance            Measure count and running time of key functions and display stats table\n      --performance-fn [name]  Measure only function [name]\n  -u, --duration               Print total running time (zero overhead, no instrumentation)\n      --trace                  Show trace output\n      --trace-dependency [name]  Show files that import the named dependency\n      --trace-export [name]    Show trace output for named export(s)\n      --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, cycles\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
 export type ParsedCLIArgs = ReturnType<typeof parseCLIArgs>;
 export default function parseCLIArgs(): {
     cache?: boolean | undefined;
     'cache-location'?: string | undefined;
     config?: string | undefined;
+    cycles?: boolean | undefined;
     debug?: boolean | undefined;
     dependencies?: boolean | undefined;
     directory?: string | undefined;

package/dist/util/cli-arguments.js

@@ -24,11 +24,12 @@ Mode
 Scope
   -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)
   -D, --directory [dir]        Run process from a different directory (default: cwd)
-      --include                Report only provided issue type(s), can be comma-separated or repeated (1)
+      --include                Include provided issue type(s), can be comma-separated or repeated (1)
       --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
       --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog
       --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates
       --files                  Shortcut for --include files
+      --cycles                 Shortcut for --include cycles (circular dependencies)
       --tags                   Include or exclude tagged exports
 
 Fix
@@ -62,9 +63,9 @@ Troubleshooting
       --trace-export [name]    Show trace output for named export(s)
       --trace-file [file]      Show trace output for exports in file
 
-(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog
+(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog, cycles
 (2) Fixable issue types: dependencies, exports, types, files, catalog
-(3) Built-in reporters: symbols (default), compact, codeowners, json, codeclimate, markdown, disclosure, github-actions
+(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions
 
 Examples:
 
@@ -84,6 +85,7 @@ export default function parseCLIArgs() {
             cache: { type: 'boolean' },
             'cache-location': { type: 'string' },
             config: { type: 'string', short: 'c' },
+            cycles: { type: 'boolean' },
             debug: { type: 'boolean', short: 'd' },
             dependencies: { type: 'boolean' },
             directory: { type: 'string', short: 'D' },