PackMate
Β· English Β· Korean
--- Packmate is a modern CLI tool for managing, updating, and cleaning up your Node.js project dependencies. It supports **npm**, **pnpm**, and **yarn**. With an intuitive interactive UI and powerful performance optimizations, Packmate helps you keep your project healthy and up-to-dateβfaster and safer than ever. ## π€ Why Packmate? - **β‘ Performance**: Faster repeat runs with caching and parallel analysis - **π― Accuracy**: Unused package detection with dev tool intelligence and cross-validation - **π‘οΈ Safety**: Smart fallback for package managers, unused packages excluded from updates - **π¨ Clarity**: Grouped UI sessions (Patch/Minor/Major) with color-coded updates - **π§ Flexibility**: Full configuration support via `packmate.config.json` - **π Modern**: Clean, professional English interface with intuitive workflows ## π Features ### Performance & Optimization - **3-Level Caching System**: Memory β Disk (1hr TTL) β Network - First run: Standard speed - Second run: Faster with cached registry data - **Worker Pool Processing**: Multi-core CPU utilization for file scanning (**2-4x faster**) - **Compressed Caching**: Experimental Brotli-based cache storage - **Predictive Caching**: Experimental package prediction and pre-loading - **Adaptive Concurrency**: Dynamic request throttling based on CPU cores (8-16 concurrent) ### Security Awareness - **Security Advisories**: - npm audit based advisory detection - Direct/transitive advisory distinction - Security update candidates in the interactive flow - Transitive advisories explained without misleading direct selection ### Smart Detection - **Enhanced Unused Detection**: - Dynamic import detection: `import('module')` - Conditional require detection: `try-catch`, `if` blocks - DevDependencies intelligence: Recognizes build tools, linters, type definitions - Cross-validation: precinct + depcheck for high confidence - **Update Detection**: - Grouped by Patch/Minor/Major with color coding - Unused packages are reviewed before update selection - Direct security advisories can be surfaced in the update flow - Semver-aware version comparison - **Installation Detection**: Finds declared but not installed packages ### UI/UX Excellence - **Grouped UI Sessions**: - πΉ **Patch Updates** (Green): Bug fixes, safe to update - πΈ **Minor Updates** (Yellow): New features, backward compatible - πΆ **Major Updates** (Red): Breaking changes, requires review - ποΈ **Unused Packages**: High/Medium confidence levels - π₯ **Not Installed**: Missing declared dependencies - π‘οΈ **Security Advisories**: Direct/transitive advisory distinction - **Safety Features**: - Confirmation prompt for major updates - Breaking change warnings - Clear action summaries - **Visual Enhancements**: - Color-coded version changes - Progressive feedback during analysis - Compact summary and final action review ### Configuration & Flexibility - **Smart Package Manager Detection**: - Auto-detects from lock files (pnpm-lock.yaml, yarn.lock, package-lock.json) - Verifies installation status - Auto-fallback to available manager with helpful tips - **Configurable Options**: - Custom ignore patterns (glob support) - Analysis modes (conservative/moderate/aggressive) - UI customization (default selections, color schemes) - Cache settings (duration, location) ## πΎ Installation ```sh npm install -g packmate # or pnpm add -g packmate # or yarn global add packmate ``` You can also run it instantly with: ```sh npx packmate ``` ## π Usage ### Basic Usage From your project root, just run: ```sh packmate ``` ### Command Line Options ```sh packmate ``` Packmate is intentionally interactive. Run it from your project directory and choose updates, removals, and security actions from the guided prompts. **Typical Workflow Example:** ```sh β π¦ Packmate: Dependency Updates & Cleanup β β Multiple lock files found. Which package manager should PackMate use? β pnpm Analysis Summary Category Count Details Updates 7 Available package updates Unused 1 Possible cleanup candidates Missing 0 Declared but not installed Current 9 Already up-to-date Security 2 advisories 1 direct, 1 transitive ποΈ Unused Packages (High Confidence: 1) Likely safe to remove β β Select packages to remove: β none Security Risk: High (1) Update recommended β β Select security updates: β lodash 2 advisories πΆ Major Updates (3) β οΈ Breaking changes possible - Review carefully β β Select major updates (caution required): β none Review Actions Security updates (1) - lodash (high) Updates (2) - fs-extra β 11.3.5 - js-yaml β 4.1.1 β β Proceed with 3 action(s)? β No β No changes were made. β β Packmate complete! π ``` ## βοΈ Requirements - Node.js v18 or later - Supports npm, yarn, and pnpm - Works on Mac, Linux, and Windows ## π CLI Options No extra options neededβjust run packmate in your project directory. All selections (update, remove, install) are interactive. ## βοΈ Configuration Packmate supports configuration via `packmate.config.json` or the `packmate` field in your `package.json`. ### Example `packmate.config.json`: ```json { "ignorePatterns": ["@types/*", "eslint-*"], "analysisMode": { "unused": "moderate", "devDeps": true }, "ui": { "groupSessions": true, "colorScheme": "auto", "defaultChecked": { "updateAvailable": true, "unused": false, "notInstalled": true, "latest": false } }, "detection": { "dynamicImport": true, "conditionalRequire": true, "ignoreUnused": [ "eslint", "prettier", "jest", "webpack" ] } } ``` ### Configuration Options: - **ignorePatterns**: Array of glob patterns to ignore packages (e.g., `["@types/*"]`) - **analysisMode.unused**: Detection mode - `"conservative"` | `"moderate"` | `"aggressive"` - **analysisMode.devDeps**: Whether to analyze devDependencies separately - **ui.groupSessions**: Enable grouped UI sessions (Patch/Minor/Major) - **ui.defaultChecked**: Default selection states for each package type - **detection.dynamicImport**: Enable dynamic import detection - **detection.conditionalRequire**: Enable conditional require detection - **detection.ignoreUnused**: List of packages to always ignore in unused detection ### Cache Management Packmate automatically caches registry responses for faster subsequent runs. Clear cache if needed: ```bash # Windows del /q %TEMP%\packmate-cache\* # Linux/Mac rm -rf /tmp/packmate-cache/* ``` Cache location: - Windows: `C:\Users\Made with β€οΈ by AGUMON π¦