Analyze Command

The default npx depfixer command runs a smart analysis that scans your project and offers to fix any issues found.

Usage

npx depfixer [options]

Options

Option	Description
`--path <dir>`	Project directory (default: current)
`--json`	Output as JSON
`--ci`	CI mode with exit codes

How It Works

1. Free Audit

First, DepFixer performs a free audit showing your health score and issues:

📊 ANALYSIS REPORT
──────────────────────────────────────────────────
🏥 Health:  [████████░░] 72/100 (WARNING)
⚠️  Issues:  10 Conflicts Found

SEVERITY BREAKDOWN
--------------------------------------------------
  CRITICAL   1 issue require attention
  HIGH       3 issues with compatibility problems
  MEDIUM     2 issues with version conflicts
  LOW        4 issues to review
    + 2 missing peer dependencies to install.
    Unlock to see details and recommended fixes.

💡 DIAGNOSIS:
    Deep dependency graph conflicts detected.
    Manual resolution is likely to fail.

🔒 SOLUTION:
    ✓ Deterministic fix calculated.
    [?] Unlock recommended versions?

2. Unlock Prompt

A cost box shows the credit cost:

+--------------------------------------------------+
|                                                  |
|  COST TO ANALYZE:   15 CREDITS                   |
|  PLAN SIZE:         Tier: Small                  |
|                                                  |
+--------------------------------------------------+

3. Full Solution (After Payment)

Once paid, you see the complete fix with recommended versions:

🔓 FULL ANALYSIS
──────────────────────────────────────────────────

PACKAGE                            CURRENT       TARGET        TYPE
---------------------------------------------------------------------------
@angular/core                      16.0.0        17.3.0        Major
@angular/cli                       16.0.0        17.3.0        Major
typescript                         4.9.5         5.4.5         Major
rxjs                               7.5.0         7.8.1         Minor
---------------------------------------------------------------------------
eslint                             -             8.57.0        Add

⚙️  Engine Requirements:
   • Node.js: >=18.13.0

📦 Packages to Add:
   + eslint
     Required as peer dependency by eslint-config-next (^8.0.0)

Issue Types Detected

Type	Description
Peer Dependency Conflict	Package requires a different version of another package
Missing Peer Dependency	Required peer dependency not installed
Version Mismatch	Packages in same ecosystem have incompatible versions
Deprecated Package	Package is deprecated, replacement available
Framework Incompatibility	Package version incompatible with your framework

JSON Output

npx depfixer --json

{
  "mode": "audit",
  "analysisId": "abc123",
  "healthScore": 72,
  "totalPackages": 45,
  "summary": {
    "critical": 1,
    "high": 3,
    "medium": 2,
    "low": 4
  },
  "issueCount": 10,
  "conflicts": [...],
  "framework": { "name": "angular", "version": "16.0.0" },
  "cost": 15,
  "tierName": "Small"
}

CI Mode

npx depfixer --ci

Requires DEPFIXER_TOKEN environment variable:

  CI Mode - Dependency Analysis
  ────────────────────────────────────────
  Health Score: 72/100
  Total Packages: 45
  Issues Found: 10
    Critical: 1
    High: 3
    Medium: 2
    Low: 4

  Pipeline should fail - critical/high issues detected

Exit codes:

0 - No critical/high issues
1 - Critical or high issues found
2 - Error (auth, network)

Audit vs Full Mode

Feature	Audit (Free)	Full (Paid)
Health score	✓	✓
Issue count	✓	✓
Severity breakdown	✓	✓
Package names	Limited	✓
Recommended versions	✗	✓
Apply fixes	✗	✓

Getting Started

CLI Commands

Authentication

Guides

Pricing

Analyze

Analyze Command

Usage

Options

How It Works

1. Free Audit

2. Unlock Prompt

3. Full Solution (After Payment)

Issue Types Detected

JSON Output

CI Mode

Audit vs Full Mode

​Analyze Command

​Usage

​Options

​How It Works

​1. Free Audit

​2. Unlock Prompt

​3. Full Solution (After Payment)

​Issue Types Detected

​JSON Output

​CI Mode

​Audit vs Full Mode

Analyze Command

Usage

Options

How It Works

1. Free Audit

2. Unlock Prompt

3. Full Solution (After Payment)

Issue Types Detected

JSON Output

CI Mode

Audit vs Full Mode