PackMate

🤖 Your smart and friendly CLI assistant for dependency updates and cleanup

· 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: 6x faster with 3-level caching system (memory + disk + network)
- 🎯 Accuracy: 90%+ unused package detection with dev tool intelligence
- 🛡️ 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

$3

- 3-Level Caching System: Memory → Disk (1hr TTL) → Network
- First run: Standard speed
- Second run: 6x faster with cached registry data
- Parallel Processing: Multi-core CPU utilization for file scanning (2-4x faster)
- Adaptive Concurrency: Dynamic request throttling based on CPU cores (8-16 concurrent)

$3

- Enhanced Unused Detection (90%+ accuracy):
- 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 automatically excluded from update suggestions
- Semver-aware version comparison
- Installation Detection: Finds declared but not installed packages

$3

- 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
- ✅ Up-to-date: Informational list (non-selectable)
- Safety Features:
- Confirmation prompt for major updates
- Breaking change warnings
- Clear action summaries
- Visual Enhancements:
- Color-coded version changes
- Progress bars for long operations
- Fixed console box alignment

$3

- 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

From your project root, just run:

`sh
packmate
`

Typical Workflow Example:

`sh
┌ 📦 Packmate: Dependency Updates & Cleanup
│
◇ Info ─────────────────╮
│ Package Manager: npm │
├────────────────────────╯
│
Progress |████████████████████████████████████████| 17/17 (100%)
◇ ✅ Found 3 packages with available updates
◇ ✅ Unused package analysis complete
◇ ✅ Found 0 not installed packages

📊 Analysis Results:
Updates available: 3
Unused: 1
Not installed: 0
Up-to-date: 13

🔶 Major Updates (3)
⚠️ Breaking changes possible - Review carefully
│
◇ Select major updates (caution required):
│ ◼ globby 13.2.2 → 15.0.0 [MAJOR]
│ ◻ p-retry 6.2.1 → 7.1.0 [MAJOR]
│ ◻ precinct 10.0.1 → 12.2.0 [MAJOR]
│
⚠️ Proceed with 1 major update(s)? Breaking changes may be included.
│ Yes
│
🗑️ Unused Packages (High Confidence: 1)
Safe to remove
│
◇ Select packages to remove:
│ none
│
◇ Show already up-to-date packages (13)?
│ No
│
◇ Actions ───────────────────╮
│ 📝 Actions to execute: │
│ - update: globby@15.0.0 │
├─────────────────────────────╯
│
> npm install globby@15.0.0
✔️ Package update completed: globby@15.0.0

✅ Complete:
Updated: 1
Removed: 0
Installed: 0
│
└ Packmate complete! 🎉
`

⚙️ Requirements

- Node.js v16 or later (recommended v18+)
- 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.

$3

`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"
]
}
}
`

$3

- 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

$3

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\\AppData\Local\Temp\packmate-cache
- Linux/Mac: /tmp/packmate-cache`

🤝 Contributing

Contributions are always welcome! Please feel free to open an issue or submit a pull request.

💳 License

MIT

---

Made with ❤️ by AGUMON 🦖