CLI Usage

Common Commands

Scan the current directory:

sadrazam .

Scan a specific package or app:

sadrazam ./packages/web

Limit the scan to one workspace:

sadrazam . --workspace packages/web

Emit JSON:

sadrazam . --reporter json

Emit TOON:

sadrazam . --reporter toon

Focus on file and export hygiene:

sadrazam . --include unused-files,unused-exports

Measure scan performance with cache enabled:

sadrazam . --cache --performance

Trace where a package is used:

sadrazam . --trace commander

Trace where an export is used:

sadrazam . --trace-export src/lib.ts:usedHelper

Apply safe package.json cleanup and formatting:

sadrazam . --fix --format

Scan Modes

Production-only scan:

sadrazam . --production

Strict mode flags devDependencies used by production files:

sadrazam . --strict

Finding Filters

Include only selected finding types:

sadrazam . --include missing,unused-dependencies

Exclude noisy finding types:

sadrazam . --exclude unused-devDependencies

Auto-fix And Format

Use --fix to remove deterministic unused package declarations from package.json:

sadrazam . --fix

Use --fix --format to also normalize the modified package.json file:

sadrazam . --fix --format

Allowlist Flags

sadrazam . --ignore-packages react
sadrazam . --allow-unused-dev-dependencies typescript
sadrazam . --allow-missing-packages eslint

Findings

Sadrazam currently reports these main finding groups:

• missing
• unused-dependencies
• unused-devDependencies
• misplaced-devDependencies
• unused-files
• unused-exports

Use --include and --exclude to focus the output on the findings you care about.