Package Exports

@bonginkan/maria
@bonginkan/maria/package.json

Readme

🚀 MARIA v3.0.3

Stable & Reliable - AI-powered development platform with 50+ working commands, all core features fixed and production-ready.

⚡ Quick Install & Start

# Install globally
npm install -g @bonginkan/maria

# Start MARIA
maria

# Or use the short alias
mc

🎯 What is MARIA?

MARIA is an enterprise-ready AI development assistant that brings the power of multiple AI providers (OpenAI, Anthropic, Google, Groq, Ollama, etc.) directly to your terminal with 50+ slash commands for every development task.

✨ Key Features

🤖 Multi-Provider AI Support - Works with 8+ AI providers (cloud & local)
📝 50+ Working Commands - From code generation to Git operations
🧠 Intelligent Memory System - Remembers context across sessions
🔄 Git Integration - Commit, PR, merge with AI assistance
🎨 Media Generation - Create images, videos, and audio with AI
📊 Code Analysis - Security, performance, and quality checks
🚀 Zero Config - Works out of the box

📖 Available Commands (v3.0.3)

Core Commands ✅

/help                # Show all commands and usage
/clear               # Clear screen and conversation
/version             # Show MARIA version
/exit                # Exit the application

AI Development 🤖

/test                # Generate comprehensive tests
/debug               # Debug assistance with AI
/review              # Code review with suggestions
/refactor            # Intelligent code refactoring

Git Operations 📦

/commit              # Create semantic commits
/pr                  # Generate pull requests
/merge               # Merge assistance
/diff                # Analyze code differences
/branch              # Branch management

Documentation 📚

/docs                # Generate documentation
/readme              # Create README files
/api                 # API documentation
/changelog           # Generate changelogs

Code Quality 🛡️

/analyze             # Code analysis
/perf                # Performance profiling
/security            # Security scanning
/deps                # Dependency analysis
/lint                # ESLint analysis
/typecheck           # TypeScript checking

Project Management 🏗️

/scaffold            # Project scaffolding
/deploy              # Deployment assistance
/memory              # Manage project memory
/export              # Export project data

Media Creation 🎨

/image               # AI image generation
/video               # AI video creation
/audio               # Audio generation

Search & Discovery 🔍

/search              # Smart code search
/find                # File finder
/grep                # Pattern search
/replace             # Find and replace

Database & API 🗄️

/db                  # Database operations
/migrate             # Run migrations
/seed                # Seed data
/api-test            # API testing

Terminal Tools ⚙️

/run                 # Execute commands
/watch               # File watcher
/docker              # Docker management
/calc                # Calculator
/solve               # Equation solver
/plot                # Graph plotter

Learning & Help 📖

/explain             # Explain code/concepts
/tutorial            # Interactive tutorials
/example             # Show examples

Collaboration 👥

/share               # Share code/sessions
/collab              # Collaboration tools
/sync                # Sync settings
/team                # Team management

🎨 Beautiful CLI Experience

When you run maria, you'll see:

╔══════════════════════════════════════════════════════════╗
║  ███╗   ███╗ █████╗ ██████╗ ██╗ █████╗                  ║
║  ████╗ ████║██╔══██╗██╔══██╗██║██╔══██╗                 ║
║  ██╔████╔██║███████║██████╔╝██║███████║                 ║
║  ██║╚██╔╝██║██╔══██║██╔══██╗██║██╔══██║                 ║
║  ██║ ╚═╝ ██║██║  ██║██║  ██║██║██║  ██║                 ║
║  ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═╝                 ║
║        AI-Powered Development Platform                   ║
║         (c) 2025 Bonginkan Inc.                          ║
╚══════════════════════════════════════════════════════════╝

MARIA CODE v3.0.3 — Ready
/help for commands | Providers: 8/8 OK

Available AI Providers:
☁️  Cloud AI: OpenAI, Anthropic, Google, Groq, xAI
💻 Local AI: Ollama, LM Studio, vLLM

💬 Enhanced Features:
   ✅ Conversation Memory - remembers all your chats
   ⚡ Lightning Speed - 200ms thinking, intelligent responses
   🎯 Context Awareness - builds on previous conversations
   🤖 AI-Powered Responses - real intelligent assistance

🚀 Usage Examples

Generate Tests

maria
/test src/utils/calculator.ts
# AI generates comprehensive test suite

Smart Git Commits

maria
/commit
# AI analyzes changes and creates semantic commit message

Code Review

maria
/review src/components/UserProfile.tsx
# Get AI-powered code review with suggestions

Generate Documentation

maria
/docs
# Generate comprehensive documentation for your project

Create Images

maria
/image "a futuristic city at sunset"
# AI generates image based on prompt

🔧 Configuration

Environment Variables

# AI Provider API Keys (optional)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
GROQ_API_KEY=gsk_...

# Local LLM Configuration (auto-detected)
OLLAMA_BASE_URL=http://localhost:11434
VLLM_BASE_URL=http://localhost:8000
LMSTUDIO_BASE_URL=http://localhost:1234

Select AI Model

maria
/model gpt-4o        # Use GPT-4
/model claude-3      # Use Claude 3
/model gemini-pro    # Use Gemini Pro

💻 Programmatic API

Use MARIA as a Library

import { 
  IntelligentRouterService, 
  DualMemoryEngine, 
  FileSystemService 
} from '@bonginkan/maria';

// Intelligent Routing
const router = new IntelligentRouterService({
  confidenceThreshold: 0.85,
  enableLearning: true
});

const result = await router.route('optimize my database queries');
console.log('Command:', result.command);
console.log('Confidence:', result.confidence);

// Dual Memory System
const memory = new DualMemoryEngine({
  system1: { maxKnowledgeNodes: 1000 },
  system2: { maxReasoningTraces: 100 }
});

await memory.store({ type: 'knowledge', data: {...} });
const insights = await memory.query('previous optimization patterns');

// File System Operations
const fs = new FileSystemService({ 
  safeMode: true,
  atomicWrites: true 
});

await fs.writeFile('output.ts', generatedCode);

📊 v3.0.3 Statistics

Total Commands: 69 defined
Working Commands: 50 (displayed in help)
Hidden Commands: 11 (being fixed)
Categories: 18
Success Rate: 77%
Bundle Size: ~1.4MB
Supported Providers: 8+

🐛 What's Fixed in v3.0.3

✅ All undefined variable errors in core services
✅ /clear command execution errors
✅ /model command variable references
✅ /version command display
✅ Help command showing accurate counts
✅ Hidden broken commands from help display
✅ Dynamic command counting in /help

🔮 Roadmap

Fix remaining 11 commands
Add GPT-4 Vision support
Enhanced memory persistence
Team collaboration features
Plugin system
Web UI dashboard

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

📄 License

🙏 Acknowledgments

Thank you to all users who reported issues and helped make MARIA more stable and reliable.

Need help? Run maria then type /help
Found a bug? Open an issue
Want to contribute? Submit a PR

MARIA - Your AI-Powered Development Assistant
Making development faster, smarter, and more enjoyable.