Usage

How to use Codependence

Getting Started

Use Codependence as a standalone CLI, in npm scripts, in CI, or as a Node utility.

Installation

# Using npm
npm install codependence --save-dev

# Using bun
bun add codependence --dev

# Using yarn
yarn add codependence --dev

# Using pnpm
pnpm add codependence --save-dev

Quick Setup

Check only selected dependencies:

codependence --codependencies 'fs-extra' 'lodash'

Or use it with a config in the root package.json file

{
  "codependence": {
    "codependencies": ["fs-extra", "lodash"]
  },
  "scripts": {
    "update-codependencies": "codependence --update",
    "prepare": "bun run update-codependencies"
  }
}

Pin selected packages while updating the rest:

codependence --permissive --codependencies 'react' 'lodash' --update

Initialize Codependence

Quickly set up Codependence in your project with the interactive init command:

# Interactive setup with permissive mode by default - recommended!
codependence init

# Create .codependencerc with all dependencies pinned (legacy mode)
codependence init rc

# Add configuration to package.json with all dependencies pinned (legacy mode)
codependence init package

Init command:

  • Interactive setup can create permissive mode configs (update all, pin specific ones)
  • Scans package.json for dependencies
  • Choose strategy: 🚀 Permissive (recommended) or 🔒 Pin all
  • Creates .codependencerc or updates package.json
  • Handles missing files and invalid JSON