š¤ AI-Powered Development Assistant - Intelligent code analysis, problem solving, and terminal automation using Gemini API
npm install blue-beatlebash
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
4. Start using Blue Beatle:
`bash
blue-beatle ai "Help me analyze my code"
blue-beatle interactive
`
š Usage Examples
$3
`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
`
$3
`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
`
$3
`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
`
$3
`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 | 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 | 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
$3
`bash
blue-beatle config --setup-api
`
$3
`bash
macadida config --list
`
$3
`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
š What's New
$3
- š 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.
`bash
Development setup
git clone https://github.com/engineermarcus/marcus-alias.git
cd marcus-alias
npm install
npm run dev
``