blue-beatle

# 🤖 Blue Beatle - AI-Powered Development Assistant [![npm version](https://badge.fury.io/js/blue-beatle.svg)](https://badge.fury.io/js/blue-beatle) [![Downloads](https://img.shields.io/npm/dm/blue-beatle.svg)](https://npmjs.org/package/blue-beatle) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)](https://nodejs.org/) **Blue Beatle** is an intelligent AI-powered development assistant that revolutionizes your coding workflow. Built with Google's Gemini AI, it provides intelligent code analysis, automated problem-solving, smart terminal execution, and comprehensive project management. ## ✨ Key Features 🧠 **AI-Powered Intelligence** - Smart code analysis and problem-solving with Gemini AI ⚡ **Smart Terminal** - Intelligent command execution with safety checks 🔍 **Code Analysis** - Security, performance, and quality assessment 📁 **Project Management** - Automated setup, testing, and deployment 🎯 **Interactive Mode** - Continuous AI conversation about your code ## 🚀 Quick Installation ```bash npm install -g blue-beatle ``` > **Note**: After installation, run `npm install` in the package directory to install dependencies, then use `blue-beatle config --setup-api` to configure your Gemini API key. ## ⚙️ Quick Setup 1. **Install globally:** ```bash npm install -g blue-beatle ``` 2. **Run initial setup:** ```bash blue-beatle setup ``` 3. **Configure your Gemini API key:** ```bash blue-beatle config --setup-api ``` Get your free API key at: [Google AI Studio](https://makersuite.google.com/app/apikey) 4. **Start using Blue Beatle:** ```bash blue-beatle ai "Help me analyze my code" blue-beatle interactive ``` ## 📖 Usage Examples ### 🧠 AI Assistant ```bash # Ask AI for coding help blue-beatle ai "How do I optimize this React component?" # Analyze specific files blue-beatle ai "Review this file for bugs" --file src/app.js # Interactive AI chat blue-beatle interactive ``` ### 🔍 Code Analysis ```bash # Analyze current directory blue-beatle analyze # Security audit blue-beatle analyze --type security --fix # Performance analysis blue-beatle analyze --type performance # Watch for changes blue-beatle watch --auto-fix ``` ### ⚡ Smart Terminal ```bash # Execute with AI assistance blue-beatle exec "npm install react" # Interactive mode with suggestions blue-beatle exec "git commit" --interactive # Safe mode for dangerous commands blue-beatle exec "rm -rf node_modules" --safe ``` ### 📁 Project Management ```bash # Initialize new project blue-beatle project --init # Setup React project blue-beatle project --setup react # Deploy project blue-beatle project --deploy # Run tests with analysis blue-beatle project --test ``` ## 🎯 Core Commands | Command | Description | |---------|-------------| | `blue-beatle ai <prompt>` | Ask AI to solve coding problems | | `blue-beatle interactive` | Start interactive AI chat mode | | `blue-beatle analyze [path]` | Analyze code for issues | | `blue-beatle exec <command>` | Execute commands with AI help | | `blue-beatle project --init` | Initialize new project | | `blue-beatle config --setup-api` | Setup Gemini API key | | `blue-beatle setup` | Run initial setup wizard | ## 🔧 Configuration ### API Key Setup ```bash blue-beatle config --setup-api ``` ### View Settings ```bash macadida config --list ``` ### Customize Settings ```bash macadida config --set ai.temperature=0.7 macadida config --set terminal.safeMode=true ``` ## 📊 Supported Technologies - **Languages**: JavaScript, TypeScript, Python, Rust, Go, Java, C/C++, PHP, Ruby - **Frameworks**: React, Vue, Angular, Node.js, Express, Django, Flask, Spring Boot - **Tools**: Docker, Git, npm, yarn, pip, cargo, maven, gradle - **Cloud**: AWS, Azure, GCP, Vercel, Netlify, Heroku ## 🔒 Security & Privacy - **Local Processing**: Most analysis happens on your machine - **Secure Storage**: API keys encrypted with AES-256-GCM - **No Code Upload**: Your code stays local unless explicitly shared - **Privacy First**: Optional telemetry with full transparency ## 🛠️ Requirements - **Node.js**: 16.0.0 or higher - **npm**: 8.0.0 or higher - **Gemini API Key**: Free at [Google AI Studio](https://makersuite.google.com/app/apikey) ## 📈 What's New ### Version 1.0.0 - 🎉 Initial release with full AI integration - 🧠 Gemini 2.5 Pro AI model support - 🔍 Advanced code analysis engine - ⚡ Smart terminal execution - 📁 Project management automation - 🎯 Interactive AI chat mode ## 🤝 Contributing We welcome contributions! See our [Contributing Guide](https://github.com/engineermarcus/marcus-alias/blob/main/CONTRIBUTING.md) for details. ```bash # Development setup git clone https://github.com/engineermarcus/marcus-alias.git cd marcus-alias npm install npm run dev ``` ## 📄 License MIT License - see [LICENSE](https://github.com/engineermarcus/marcus-alias/blob/main/LICENSE) file for details. ## 📞 Support & Community - 📖 **Documentation**: [GitHub Wiki](https://github.com/engineermarcus/marcus-alias/wiki) - 🐛 **Bug Reports**: [GitHub Issues](https://github.com/engineermarcus/marcus-alias/issues) - 💬 **Discussions**: [GitHub Discussions](https://github.com/engineermarcus/marcus-alias/discussions) - 📧 **Email**: engineermarcus72@gmail.com ## 🌟 Show Your Support If MacAdida helps you code better, please consider: - ⭐ [Starring the repository](https://github.com/engineermarcus/marcus-alias) - 🐛 [Reporting bugs](https://github.com/engineermarcus/marcus-alias/issues) - 💡 [Suggesting features](https://github.com/engineermarcus/marcus-alias/issues) - 📝 [Contributing code](https://github.com/engineermarcus/marcus-alias/pulls) --- <div align="center"> **Made with ❤️ by [Engineermarcus](https://github.com/engineermarcus)** *Empowering developers with AI-driven productivity* [⭐ Star on GitHub](https://github.com/engineermarcus/marcus-alias) • [📦 View on npm](https://npmjs.com/package/macadida) • [🐛 Report Bug](https://github.com/engineermarcus/marcus-alias/issues) </div>