pnpm-catalog-updates

A powerful CLI tool to check and update pnpm workspace catalog dependencies, inspired by npm-check-updates.

Full Documentation: https://pcu-cli.dev

Features

• One-Command Setup: Initialize complete PNPM workspace with pcu init
• Smart Detection: Automatically discovers pnpm workspaces and catalog configurations
• Catalog Focused: Specialized for pnpm catalog dependency management
• Interactive Mode: Choose which dependencies to update with an intuitive interface
• Impact Analysis: Understand which packages will be affected by catalog changes
• Safe Updates: Dry-run mode and backup options for safe dependency updates
• High Performance: Parallel API queries and intelligent caching
• Security Aware: Built-in security vulnerability scanning
• Beautiful UI: Enhanced progress bars, color themes, and interactive prompts
• Progress Bar Styles: Choose from gradient, fancy, minimal, rainbow, neon, or blocks styles
• Customizable Themes: Multiple color themes (default, modern, minimal, neon)
• Real-time Progress: Live progress tracking with speed indicators and time estimates
• Smart Version Check: Automatic update notifications with --version command
• Private Registry Support: Automatically reads .npmrc and .pnpmrc configurations
• Multi-Registry: Supports different registries for different package scopes
• Configurable: Flexible configuration options and update strategies

See all features and details

Quick Start

Installation

# Global installation (recommended)
npm install -g pcu

# Or use with npx
npx pnpm-catalog-updates

Basic Usage

# Initialize a new PNPM workspace with PCU configuration
pcu init

# Check for updates in existing workspace
pcu -c

# Interactive update mode
pcu -i

Complete Installation & Usage Guide

Documentation

Complete Command Reference
Configuration Guide
Examples & Use Cases

Project Structure

This project is organized as a pnpm monorepo with clean architecture:

├── apps/
│   └── cli/                    # CLI application
└── packages/
    ├── core/                   # Core business logic
    └── utils/                  # Shared utilities

Detailed Architecture Guide

Development

Prerequisites

• Node.js >= 22.0.0
• pnpm >= 10.0.0

Setup

# Clone the repository
git clone https://github.com/houko/pnpm-catalog-updates.git
cd pnpm-catalog-updates

# Install dependencies
pnpm install

# Build and run
pnpm build
pnpm dev --help

Complete Development Guide

Configuration Example

# pnpm-workspace.yaml
packages:
  - 'packages/*'

catalog:
  react: ^18.2.0
  typescript: ^5.0.0

catalogs:
  react17:
    react: ^17.0.2

// .pcurc.json
{
  "defaults": {
    "target": "latest"
  },
  "packageRules": [
    {
      "patterns": ["react", "react-dom"],
      "target": "minor"
    }
  ]
}

Configuration Examples & Templates

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup & Guidelines

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Inspired by npm-check-updates
• Built with love for the pnpm community
• Thanks to all contributors and users

Support

• Full Documentation
• Issue Tracker
• Discussions

---

Made with ❤️ for the pnpm community