Skip to main content

​
Quickstart

​
Prerequisites

  • Node.js 18 or higher
  • A JavaScript/TypeScript project with a package.json

​
Installation

​
Option 1: Use npx (no install)

npx depfixer

​
Option 2: Install globally

npm install -g depfixer
Then run: 
depfixer

​
Step 1: Run DepFixer

Open your terminal in your project directory and run depfixer (or npx depfixer).

​
Step 2: Review the Analysis

DepFixer will display the ASCII logo and scan your dependencies: 
  ██████╗  ███████╗ ██████╗ ███████╗██╗██╗  ██╗███████╗██████╗
  ██╔══██╗ ██╔════╝ ██╔══██╗██╔════╝██║╚██╗██╔╝██╔════╝██╔══██╗
  ██║  ██║ █████╗   ██████╔╝█████╗  ██║ ╚███╔╝ █████╗  ██████╔╝
  ██║  ██║ ██╔══╝   ██╔═══╝ ██╔══╝  ██║ ██╔██╗ ██╔══╝  ██╔══██╗
  ██████╔╝ ███████╗ ██║     ██║     ██║██╔╝ ██╗███████╗██║  ██║
  ╚═════╝  ╚══════╝ ╚═╝     ╚═╝     ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
           Dependency Hell? We've Got the Cure.

⚡ DepFixer CLI v1.0.0
──────────────────────────────────────────────────

📦 PROJECT: my-angular-app
   Framework: Angular

✓ Analysis complete

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

​
Step 3: Review Issues

For smaller issue counts, you’ll see a severity breakdown: 
SEVERITY BREAKDOWN
--------------------------------------------------
  CRITICAL   1 issue require attention
  HIGH       3 issues with compatibility problems
  MEDIUM     2 issues with version conflicts
  LOW        4 issues to review
    Unlock to see details and recommended fixes.

​
Step 4: Unlock Solutions

If issues are found, you’ll see a cost box: 
+--------------------------------------------------+
|                                                  |
|  COST TO ANALYZE:   15 CREDITS                   |
|  PLAN SIZE:         Tier: Small                  |
|                                                  |
+--------------------------------------------------+
[?] Continue to login? (Enter/Esc)
Press Enter to proceed.

​
Step 5: Authenticate

First-time users will see the device code flow: 
🔐 DEVICE CODE LOGIN
──────────────────────────────────────────────────

    Your verification code:

          ABCD-1234

    Opening browser to complete login...
    Waiting for authorization...
Enter the code in your browser to authenticate.

​
Step 6: Apply Fixes

Once authenticated with sufficient credits, you’ll see the full solution: 
🔓 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

────────────────────────────────────────
  📝 Only package.json will be modified
  💾 A backup (package.json.bak) will be created
────────────────────────────────────────

Apply fix to package.json? (Enter/Esc)
Press Enter to apply.

​
Step 7: Done!

✨ SUCCESS
──────────────────────────────────────────────────

    ✓ 4 Packages Updated
    ✓ Backup: package.json.bak

    👉 NEXT STEP:
    Run the following command to finalize changes:

    $ npm install
Run npm install to install the updated dependencies.

​
Other Ways to Use DepFixer

​
GitHub Action

Automatically check dependencies on every pull request:
.github/workflows/depfixer.yml
name: Dependency Check
on: [pull_request]

jobs:
  depfixer:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: depfixer/action@v1
        with:
          api-key: ${{ secrets.DEPFIXER_API_KEY }}
See the GitHub Action guide for full configuration options.

​
MCP Server (AI IDE Integration)

Use DepFixer tools directly in Claude Code, Cursor, or Windsurf: 
npx @depfixer/mcp-server
Then ask your AI assistant: “Analyze my package.json for dependency issues” See the MCP Server guide for setup instructions.