---

Always Up To Date

A smart CLI tool that automatically keeps your dependencies up to date with intelligent package manager detection and workspace support.

✨ Features

• 📦 Universal Package Manager Support - Automatically detects and works with npm, yarn, pnpm, and bun
• 🔍 Dependency Checking - Check for outdated packages across your project
• 🚀 Smart Updates - Update packages while respecting workspace configurations
• 🏢 Workspace Support - Full support for npm workspaces and monorepo structures
• 🎯 Intelligent Detection - Automatically detects your package manager from lock files
• 🛠️ Extensible Architecture - Modular design with dedicated managers, migrators, and PR generators

🏗️ Architecture

The tool is built with a modular architecture:

• Managers - Package manager specific implementations (npm, yarn, pnpm, bun)
• Migrators - Smart migration rules for popular packages (React, Next.js, etc.) (Coming Soon!)
• PR Generators - Automated pull request creation with detailed migration guides (Coming Soon!)
• Command Runner - Unified command execution across all package managers

🔜 Coming Soon

• Migration rules for popular frameworks (React, Next.js, etc.)
• GitHub integration with automated PR creation
• Security vulnerability scanning

📋 Requirements

• Node.js 24 or higher
• One of: npm, yarn, pnpm (10+), or bun

🚀 Quick Start

# Global installation (recommended)
npm install -g @pixel-perfect-software/always-up-to-date

# Initialize the library
autd init

# Check for outdated dependencies
autd check

# Update outdated dependencies
autd update

🔧 Usage Examples

# Check for outdated dependencies
autd check

# Check with JSON output (useful for CI/CD pipelines)
autd check --json

# Update all eligible dependencies
autd update

# Update specific packages only
autd update react lodash @babel/core

# Preview what would be updated without making changes
autd update --dry-run

# Interactively select which packages to update
autd update --interactive

# Combine flags: dry-run specific packages with JSON output
autd update react --dry-run --json

# Get help and see all available commands
autd help

📦 Package Manager Detection

The tool automatically detects your package manager by looking for lock files:

• npm - package-lock.json
• yarn - yarn.lock
• pnpm - pnpm-lock.yaml
• bun - bun.lock

🏢 Workspace Support

Full support for workspaces and monorepos:

• npm workspaces - Automatically detected from package.json workspaces field
• yarn workspaces - Automatically detected from package.json workspaces field
• pnpm workspaces - Automatically detected from pnpm-workspace.yaml
• bun workspaces - Automatically detected from package.json workspaces field

🛠️ Available Commands

Command	Description
autd init	Initialize configuration in the current directory
autd check	Check for outdated dependencies in your project
autd check --json	Output outdated packages as JSON
autd update	Update all eligible dependencies
autd update [packages...]	Update only the specified packages
autd update --dry-run	Preview which packages would be updated
autd update -i, --interactive	Interactively select packages to update
autd update --json	Output update results as JSON
autd help	Display help information

⚙️ Configuration

Run autd init to create a .always-up-to-date.json file in your project root:

{
  "allowMinorUpdates": false,
  "allowMajorUpdates": false,
  "updateAllowlist": [],
  "updateDenylist": [],
  "debug": false,
  "silent": false
}

Option	Default	Description
allowMinorUpdates	false	Allow minor version updates (e.g., 1.0.0 → 1.1.0)
allowMajorUpdates	false	Allow major version updates (e.g., 1.0.0 → 2.0.0). Implies allowMinorUpdates.
updateAllowlist	[]	Packages that are always updated regardless of version type
updateDenylist	[]	Packages that are never updated
debug	false	Enable debug logging
silent	false	Suppress all output

Patch updates (e.g., 1.0.0 → 1.0.1) are always allowed unless a package is on the deny list.

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide for details on how to get started.

💸 Support this package's development & maintenance

📝 License

MIT © Tyler Robertson @ Pixel Perfect Software Inc. - See LICENSE for details.