🤖 Blue Beatle - AI-Powered Development Assistant

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

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:

   npm install -g blue-beatle

2. Run initial setup:

   blue-beatle setup

3. Configure your Gemini API key:

   blue-beatle config --setup-api

   Get your free API key at: Google AI Studio

4. Start using Blue Beatle:

   blue-beatle ai "Help me analyze my code"
   blue-beatle interactive

📖 Usage Examples

🧠 AI Assistant

# 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

# 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

# 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

# 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

blue-beatle config --setup-api

View Settings

macadida config --list

Customize Settings

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

📈 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 for details.

# Development setup
git clone https://github.com/engineermarcus/marcus-alias.git
cd marcus-alias
npm install
npm run dev

📄 License

MIT License - see LICENSE file for details.

📞 Support & Community

• 📖 Documentation: GitHub Wiki
• 🐛 Bug Reports: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: [email protected]

🌟 Show Your Support

If MacAdida helps you code better, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting features
• 📝 Contributing code

Made with ❤️ by Engineermarcus

Empowering developers with AI-driven productivity

⭐ Star on GitHub • 📦 View on npm • 🐛 Report Bug