kingjethroPackage Checker CLI
An AI-powered CLI tool for intelligent dependency analysis, code assistance, and automated project management.
🚀 Features
- 🤖 AI-Powered Help - Ask questions in natural language and get intelligent solutions
- 🔍 Smart Dependency Analysis - Detect missing, unused, and uninstalled dependencies
- 🛠️ Automated File Operations - AI can create, modify, and delete files with your permission
- 📊 Multi-Language Support - Works with npm, yarn, composer, pip, and more
- ⚡ One-Command Fixes - Install, uninstall, and fix dependencies automatically
- 📍 File Location Tracking - See exactly where unused dependencies are imported
- 🔒 Security Audits - AI-powered security vulnerability detection
- 📈 Performance Tips - Get suggestions to optimize your project
📦 Installation
Global Installation
npm install -g package-checker-cliLocal Usage
npx package-checker-cli🎯 Quick Start
- Navigate to your project directory
- Run dependency analysis:
checker check - Get AI help:
checker help "describe your problem" - Fix issues automatically:
checker fix
🤖 AI-Powered Help
The standout feature - ask for help in natural language:
# Get help with any coding problem
checker help "my file is not running"
checker help "npm install fails with permission errors"
checker help "how do I optimize my webpack config"
# Auto-apply suggested fixes (skips confirmation)
checker help "fix my package.json dependencies" --autoThe AI can:
- ✅ Analyze your problem and suggest solutions
- ✅ Create new files with proper code
- ✅ Modify existing files to fix issues
- ✅ Delete problematic files
- ✅ Provide code examples and resources
- ✅ Always asks for your permission before making changes
📋 Commands
Core Commands
checker help <query>
Ask AI for help with any coding problem or project issue.
checker help "my tests are failing"
checker help "how to setup eslint" --autoOptions:
--auto- Automatically apply suggested file operations without confirmation
checker check [options]
Analyze project dependencies for issues.
checker check # Basic analysis
checker check --ai # AI-powered analysis with insights
checker check --json # Output in JSON format
checker check --path ./src # Scan specific pathchecker fix [options]
Automatically fix dependency issues.
checker fix # Fix all issues
checker fix --dry-run # Preview what would be fixed
checker fix --path ./project # Fix specific pathchecker doctor [options]
Comprehensive project health check.
checker doctor # Basic health check
checker doctor --ai # AI-powered health analysis
checker doctor --path ./src # Check specific pathPackage Management
checker install <module>
Install a specific missing dependency.
checker install lodash
checker install express --path ./backendchecker uninstall <module>
Remove unused dependencies.
checker uninstall unused-package
checker uninstall old-lib --path ./frontendchecker list [options]
List all dependencies by status.
checker list # Show all dependencies
checker list --json # JSON output
checker list --path ./src # List for specific pathProject Maintenance
checker scan <path>
Scan specific directory or file.
checker scan ./src # Scan source directory
checker scan ./package.json --ai # AI analysis of package.json
checker scan . --json # JSON output for entire projectchecker sync [options]
Reinstall all dependencies (like npm ci).
checker sync # Sync current directory
checker sync --path ./project # Sync specific projectchecker clean [options]
Remove unused dependencies from package.json.
checker clean # Remove unused deps
checker clean --dry-run # Preview what would be removed
checker clean --path ./app # Clean specific pathConfiguration
checker config [options]
Manage CLI configuration.
checker config --set ignored="test,build"
checker config --get ignored
checker config --listchecker update
Update the CLI tool to latest version.
checker update🌍 Supported Languages & Package Managers
- JavaScript/TypeScript: npm, yarn, pnpm
- PHP: Composer
- Python: pip, pipenv, poetry
- Ruby: Bundler
- Go: Go modules
- Rust: Cargo
- Java: Maven, Gradle
- .NET: NuGet
- Dart/Flutter: pub
🧠 AI Features
Powered by Google's Gemini AI, providing:
- Natural Language Processing: Understand your problems in plain English
- Intelligent Code Analysis: Analyze your codebase for issues
- Automated Solutions: Generate and apply fixes automatically
- Package Insights: Smart recommendations for updates and alternatives
- Security Analysis: Vulnerability detection and remediation
- Performance Optimization: Code and dependency optimization tips
🔧 Advanced Usage
Batch Operations
# Check multiple projects
for dir in */; do checker check --path "$dir"; done
# Fix all projects in workspace
find . -name "package.json" -execdir checker fix \;CI/CD Integration
# In your CI pipeline
checker check --json > dependency-report.json
checker doctor --ai || exit 1Configuration File
Create .checkerrc in your project:
{
"ignored": ["test", "build", "docs"],
"autoFix": false,
"aiEnabled": true
}📖 Examples
Common Workflows
New Project Setup:
checker help "setup a new React project with TypeScript"Dependency Issues:
checker check --ai
checker fixPerformance Optimization:
checker help "my app is slow, how to optimize"Security Audit:
checker doctor --ai🛠️ Requirements
- Node.js 16.0.0 or higher
- npm, yarn, or pnpm (for Node.js projects)
- Internet connection for AI features
🐛 Troubleshooting
Common Issues:
- Permission Errors: Run with
sudoon macOS/Linux if needed - API Failures: Check internet connection for AI features
- Large Projects: May take longer to analyze (>1000 files)
Get Help:
checker help "I'm having trouble with [describe your issue]"🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
MIT License - see LICENSE file for details.
Made with ❤️ by King Jethro
Transform your development workflow with AI-powered assistance!