> ## Documentation Index
> Fetch the complete documentation index at: https://docs.depfixer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analyze

> Scan your project for dependency issues

# Analyze Command

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

## Usage

```bash theme={null}
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

```bash theme={null}
npx depfixer --json
```

```json theme={null}
{
  "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

```bash theme={null}
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**          | ✗            | ✓           |