📦 Package Installer CLI

A powerful, cross-platform CLI for modern development workflows. Create projects, manage dependencies, analyze codebases, and streamline your development process with intelligent automation.

🚀 Core Features

• 🎨 Project Creation: React, Next.js, Express, Angular, Vue, Rust templates
• 🚀 Cloud Deployment: Seamless deployment to Vercel, AWS, GitHub Pages
• 📊 Code Analysis: Comprehensive project analytics and insights
• 📦 Dependency Management: Smart updates across multiple package managers
• 🩺 Health Diagnostics: Automated issue detection and fixes
• 🌍 Environment Analysis: Development environment optimization
• 🗄️ Intelligent Caching: Performance optimization with smart caching
• 📈 Usage Analytics: Real-time insights and productivity metrics
• ⚡ Cross-Platform: Windows, macOS, Linux support

📥 Installation

# Using npm (recommended)
npm install -g @0xshariq/package-installer

# Using yarn
yarn global add @0xshariq/package-installer

# Using pnpm
pnpm add -g @0xshariq/package-installer

📋 Complete Installation Guide: For all installation methods including Python, Rust, Ruby, Go, Homebrew, and Docker, see installation.md

🐳 Docker Installation

Run Package Installer CLI in a containerized environment with Docker:

Quick Usage with Docker

# Pull the latest image
docker pull 0xshariq/package-installer-cli:latest

# Run interactively with current directory mounted
docker run -it --rm \
  -v "$(pwd)":/home/pi/projects \
  -v ~/.gitconfig:/home/pi/.gitconfig:ro \
  -v ~/.ssh:/home/pi/.ssh:ro \
  0xshariq/package-installer-cli:latest

# Create a new project
docker run -it --rm \
  -v "$(pwd)":/home/pi/projects \
  0xshariq/package-installer-cli:latest create my-app

# Analyze existing project
docker run -it --rm \
  -v "$(pwd)":/home/pi/projects \
  0xshariq/package-installer-cli:latest analyze

Docker Compose Setup

# Clone the repository
git clone https://github.com/0xshariq/package-installer-cli.git
cd package-installer-cli

# Run with docker-compose
docker-compose run --rm package-installer

# Development mode with hot reload
docker-compose --profile dev run --rm package-installer-dev

Docker Image Variants

Volume Mounts

• Projects: Mount your project directory to /home/pi/projects
• Git Config: Mount ~/.gitconfig for Git authentication
• SSH Keys: Mount ~/.ssh for Git repository access

🎯 Quick Start

# Create new project interactively
pi create my-app

# Deploy to cloud platforms
pi deploy

# Analyze existing project
pi analyze

# Check project health
pi doctor

# Update dependencies
pi update

# Clean development artifacts
pi clean

📚 Documentation

🛠️ Command Overview

For complete documentation, see docs/commands.md

🏗️ Supported Technologies

For detailed information, see docs/templates.md

📧 Email Command - Direct Communication

The pi email command provides a direct communication channel with the developer for feedback, support, and contributions.

Email Categories

Custom Messages - Advanced Formatting

The custom category allows you to send personalized messages with professional formatting:

# Send a custom message
pi email custom

Formatting Guidelines:

• Plain Text: Use \n for line breaks, automatic formatting applied
• HTML Format: Use HTML tags for advanced styling
• Markdown-style: Use **bold**, *italic*, `code` in plain text
• Priority Levels: Normal, High Priority, Urgent

Example HTML Formatting:

<p>Hello there!</p>
<br>
<strong>Important Update:</strong> I have some suggestions regarding the CLI.
<br><br>
<p>Here are the key points:</p>
<ul>
<li>Feature enhancement for templates</li>
<li>Improved error handling</li>
</ul>
<br>
<em>Thank you for the amazing tool!</em>

Email Command Options

# Interactive category selection
pi email

# Specific category
pi email <category>

# Quick mode (minimal prompts)
pi email --quick <category>

# Setup email configuration
pi email --setup

# Test email functionality
pi email --test

# Check email system status
pi email --status

# Show all available categories
pi email --list

# Show help
pi email --help

Email Features

• 📧 Professional Templates: Beautifully formatted HTML emails with CSS styling
• 🔒 Secure Configuration: Your email credentials stored securely locally
• 📱 Multi-Provider Support: Gmail, Outlook, Yahoo, and custom SMTP
• ⚡ Quick Feedback: Fast feedback mode for urgent issues
• 🎨 Custom Formatting: Send personalized messages with HTML/CSS
• 📊 System Info: Automatic system information inclusion for bug reports
• 🔄 Sender Options: Choose between configured email or custom credentials

Note: Email functionality requires the Email MCP Server. The CLI will guide you through the setup process on first use.

For detailed information, see docs/templates.md

🎯 System Requirements

• Node.js: 18.0.0 or higher
• Operating Systems: Windows, macOS, Linux
• Package Managers: npm, yarn, or pnpm
• Git: Required for project initialization

🐛 Troubleshooting

Quick Fixes

# Clear cache and reinstall
npm cache clean --force
npm install -g @0xshariq/package-installer

# Use npx if global installation fails
npx @0xshariq/package-installer create my-app

# Check CLI status
pi doctor

🤝 Contributing

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

📄 License

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

🔗 Links

Official Packages

• NPM: @0xshariq/package-installer
• PyPI: package-installer-cli
• Crates.io: package-installer-cli
• RubyGems: package-installer-cli
• Docker Hub: 0xshariq/package-installer-cli

Source Repositories

• Main (Node.js): package-installer-cli
• Python: py_package_installer_cli
• Rust: rust_package_installer_cli
• Ruby: ruby_package_installer_cli
• Go: go_package_installer_cli

Support & Community

• Issues & Feedback: GitHub Issues
• Discussions: GitHub Discussions

Happy coding! 🚀 Create something amazing with Package Installer CLI.