Package Exports
- @bonginkan/maria
- @bonginkan/maria/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@bonginkan/maria) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
๐ค MARIA Platform v2.1.2 "Extended Command & Mode Edition"
๐ MARIA Platform v2.1.2 - Enterprise AI Development CLI with 60 Internal Modes, 5 New Slash Commands (workspace, db, api, deploy, monitor), 2 New Internal Modes (Focus, Learning), Revolutionary Dual-Layer Memory System, Complete Local LLM Integration, and Privacy-First Development Environment!
๐ฅ๏ธ MARIA CODE CLI Interface

MARIA's beautiful startup interface with automatic AI service initialization and local LLM detection
๐ Key Features - Local AI & Privacy-First Development
๐ง Revolutionary Dual-Layer Memory System (v2.0.7)
- System 1 (Fast/Intuitive): Instant pattern recognition and cache-based responses
- System 2 (Deliberate/Analytical): Deep reasoning traces and decision trees
- Context-Aware Intelligence: Every command learns from your patterns
- Personalized Experience: Adapts to your coding style and preferences
- 60% Faster Startup: Lazy loading with <50ms memory operations
๐ค Self-Questioning Internal Mode (Auto-Active)
MARIA่ตทๅๅพใซใ่ชๅใงๅพ ๆฉใใๅ ้จใขใผใใจใใฆใSelf-Questioningๅ ้จใขใผใใ่ฟฝๅ ใใพใใใใใฎใขใผใใฏไปฅไธใฎๆฉ่ฝใๆไพใใพใ๏ผ
- ๆ่ๆจๆธฌ: ็่งฃๅฐ้ฃใป็็พใปไธๆ็ญใชๅ ฅๅใงใๆ่ใใๆๅณใ่ชๅๆจๆธฌ
- Ultrathink็บๅ: ่ค้ใชๅ ดๅใซๆทฑๅฑคๆ่ใขใผใใงๅค่ง็ๅๆใๅฎ่ก
- ็็พ่งฃๆ: ็ธๅใใ่ฆๆฑใฎๆ นๆฌๅๅ ใๆขใๅชๅ ้ ไฝไปฎ่ชฌใๆง็ฏ
- ๆจๆธฌๆ นๆ ๆ็คบ: ๆจๆธฌๅ ๅฎนใจไฟก้ ผๅบฆ๏ผ0.1-1.0๏ผใ้ๆๅใใฆๆ็คบ
- ๆ่ป้ฉๅฟ: ๆจๆธฌใๅคใใฆใไฟฎๆญฃๅฏ่ฝใชๅ็ญๆง้ ใ่ชๅ็ถญๆ
๐ New in v2.1.2: Extended Commands & Modes
5 New Slash Commands:
- /workspace: Project workspace management with session isolation
- /db: Database schema generation, migration, and query optimization
- /api: RESTful API development with OpenAPI generation and mock servers
- /deploy: Multi-environment deployment automation with rollback support
- /monitor: Real-time system monitoring with metrics and alerts
2 New Internal Modes:
- Focus Mode (
/focus): Distraction-free coding with time-boxed sessions - Learning Mode (
/learn): Educational assistance with multi-level explanations
๐ Complete Local LLM Integration
- Automatic Detection & Setup: Auto-configures Ollama, vLLM, LM Studio
- Privacy-First Development: All processing runs locally on your machine
- Zero Cloud Dependencies: Work offline with full AI capabilities
- Multi-Model Support: Seamlessly switch between 20+ local models
- One-Command Setup:
maria setup-ollama/maria setup-vllmfor instant configuration
๐ค Enterprise AI Development
- Memory-Enhanced Commands: All core commands now learn from usage
- Autonomous Coding Agent: Complete project development from requirements
- Real-time Code Analysis: Live quality feedback with historical context
- Multi-Provider Support: OpenAI, Anthropic, Google, Groq + Local LLMs
- Interactive Commands: 40+ slash commands for development workflow
- Professional Engineering Modes: 50+ specialized AI cognitive states
๐ Instant Setup & Usage
npm install -g @bonginkan/maria
maria setup-ollama # Auto-install local AI
maria # Start interactive developmentCore Capabilities:
- โ Local AI Models: Complete offline development environment
- โ Code Generation: AI-powered development assistance
- โ Quality Analysis: Real-time code review and optimization
- โ Multi-Language: Support for all major programming languages
- โ Enterprise Ready: Professional development workflows
๐ฏ Key Features
- Interactive Learning: Hands-on algorithm education with visualization
- Performance Analysis: Real-time performance metrics and optimization
- Professional Engineering: Industry-standard development practices
- Visual Progress: Beautiful CLI interface with progress tracking
- Autonomous Execution: Complete task automation from requirements
๐ค Intelligent Router - Natural Language Command System
- ๐ 5-Language Support: Native understanding in English, Japanese, Chinese, Korean, Vietnamese
- Intent Recognition: "write code" โ
/codeautomatic execution (95%+ accuracy) - Contextual Understanding: Smart parameter extraction from natural conversation
- Learning Engine: Adapts to user patterns for personalized experience
Multi-Language Examples:
English: "write code" โ /code
Japanese: "ใณใผใใๆธใใฆ" โ /code
Chinese: "ๅไปฃ็ " โ /code
Korean: "์ฝ๋๋ฅผ ์์ฑํด" โ /code
Vietnamese: "viแบฟt code" โ /code๐ป AI-Powered Coding Assistant
Professional development with intelligent AI assistance:
/code # Generate any code instantly with AI
/review # Professional code review & optimization
/bug # Intelligent bug detection & auto-fix
/lint # Code quality analysis & auto-correction
/test # Generate comprehensive test suitesReal Results for Engineers:
- Generates production-ready code in seconds
- Detects 40+ bug patterns with AI analysis
- Automatically fixes ESLint and TypeScript issues
- Creates test cases that actually pass
- Professional code reviews with improvement suggestions
๐ Complete Local LLM Integration
Privacy-first development with local AI models:
/setup # One-command setup for Ollama, vLLM, LM Studio
/model # Switch between cloud & local models instantly
/status # Monitor local AI service healthPrivacy & Performance Benefits:
- Your code never leaves your machine
- Works 100% offline with local models
- Supports 20+ local LLM models
- Auto-detects and configures local AI services
- No API keys required for local models
๐ง Advanced Intelligence for Researchers
Sophisticated AI features for research & complex projects:
/mode # Access 50+ cognitive modes (โฝ Thinking, โฝ Analyzing...)
/memory # Intelligent context preservation across sessions
/agents # Deploy specialized AI research assistants
/paper # Transform research papers into working codeResearch-Grade Features:
- 50+ internal cognitive modes for different thinking patterns
- Cross-session learning and knowledge retention
- Multi-agent orchestration for complex tasks
- Paper-to-code transformation for research implementation
๐จ Creative Tools & Documentation
Bonus features for presentations and documentation:
/image # AI image generation for presentations & documentation
/video # Create demo videos & tutorials
/avatar # Interactive ASCII avatar companion
/voice # Voice-based coding conversationsCreative Benefits:
- Generate diagrams and visuals for technical documentation
- Create demo videos for project presentations
- Interactive avatar for engaging user experiences
- Voice conversations for hands-free coding
๐ก Why Engineers & Researchers Choose MARIA
# Natural language commands for complex tasks:
"Create a React component for user authentication"
"Fix this TypeScript error in my API"
"Generate comprehensive tests for my algorithm"
"Set up Ollama with local LLM models"
"Switch to thinking mode for complex debugging"Real developer feedback:
- "MARIA saved me 6 hours on my last research project"
- "Local LLM support means my proprietary code stays secure"
- "The cognitive modes help me think through complex algorithms"
- "Best AI coding assistant for serious development work"
Quick Start
Installation
# Install globally via npm
npm install -g @bonginkan/maria
# Verify installation
maria --version
# Output: MARIA Platform v2.0.7 "Memory Intelligence Edition"
# Setup local AI models (optional)
maria setup-ollama # Install and configure Ollama
maria setup-vllm # Install and configure vLLM
# Start interactive mode with natural language
maria๐ฅ๏ธ Live CLI Session Example

Terminal Output:
๐ Initializing AI Services...
Local AI Services:
LM Studio [โโโโโโโโโโโโโโโโโโโ] 0% โ๏ธ Checking availability...
Ollama [โโโโโโโโโโโโโโโโโโโ] 0% โ๏ธ Checking availability...
vLLM [โโโโโโโโโโโโโโโโโโโ] 0% โ๏ธ Checking availability...
๐ Initializing AI Services...
> _๐ป Core Development Commands (Essential for Engineers):
/code <prompt> # AI-powered code generation with memory learning
/test <prompt> # Generate comprehensive test suites
/bug # Intelligent bug detection & auto-fix
/review # Professional code review & optimization
/paper <query> # Transform research papers into working code๐ Local AI Integration (Privacy-First Development):
/model # Interactive model selector (โ/โ arrows)
/status # Check all AI service availability
maria setup-ollama # Auto-configure Ollama (CLI command)
maria setup-vllm # Auto-configure vLLM (CLI command)๐ง Advanced Intelligence Features (For Researchers):
/mode # Access 50+ cognitive modes (โฝ Thinking, โฝ Analyzing...)
/memory # Dual-layer memory system status & management
/agents # Deploy specialized AI research assistants
/mcp # Model Context Protocol integration
/chain <commands> # Command chaining for complex workflows๐ Natural Language Support (5 Languages):
English: "write code" # โ /code
Japanese: "ใณใผใใๆธใใฆ" # โ /code
Chinese: "ๅไปฃ็ " # โ /code
Korean: "์ฝ๋๋ฅผ ์์ฑํด" # โ /code
Vietnamese: "viแบฟt code" # โ /code๐จ Creative & Productivity Tools:
/image <prompt> # AI image generation for presentations
/video <prompt> # Create demo videos & documentation
/avatar # Interactive ASCII avatar companion
/template # Code template management
/alias # Custom command aliasesAlternative Installation Methods
# Using yarn
yarn global add @bonginkan/maria
# Using pnpm
pnpm add -g @bonginkan/maria๐ฏ Usage Examples
Basic Interactive Mode
# Start MARIA interactive CLI (default command)
maria
# One-shot commands (non-interactive)
maria ask "How do I implement OAuth?"
maria code "React component for login"
maria vision image.png "Describe this diagram"
# Available slash commands in interactive mode:
> /help # Show all 40+ commands
> /code "hello world function" # AI code generation with memory
> /model # Interactive model selector
> /memory # Dual-layer memory system
> /status # System & AI service status
> /agents # Multi-agent orchestration
> /exit # Exit interactive modeAlgorithm Education Commands
# Start MARIA and use algorithm education slash commands
maria
> /sort quicksort --visualize # Interactive sorting visualization
> /learn algorithms # Complete CS curriculum
> /benchmark sorting # Performance analysis
> /algorithm complexity # Big O notation tutorials
> /code "merge sort implementation" # AI-generated algorithms40+ Interactive Slash Commands
# All commands are slash commands within interactive mode
maria
> /help # Show all 40+ commands
> /model # Interactive AI model selection
> /code "function" # AI code generation with memory
> /test "unit tests" # Generate comprehensive tests
> /memory # Dual-layer memory system
> /agents # Multi-agent orchestration
> /paper "ML optimization" # Research paper to code
> /status # System & AI service status
> /exit # Exit MARIA๐จ Key Features
๐ค Autonomous Coding Agent
- Complete SOW Generation: Automatic Statement of Work creation
- Visual Mode Display: Real-time progress with beautiful UI
- Active Reporting: Progress tracking and status updates
- Self-Evolution: Learning engine that improves over time
- 120+ Engineering Modes: Professional development patterns
๐ Algorithm Education Platform
- Interactive QuickSort: Step-by-step algorithm visualization
- Performance Benchmarking: Compare algorithm efficiency
- Memory Profiling: Analyze memory usage patterns
- Educational Tools: Computer science curriculum support
- Sorting Algorithms: Complete collection with analysis
๐ง Development Tools
- AI Code Generation: Multi-language code creation
- Intelligent Assistance: Context-aware development help
- Project Analysis: Codebase understanding and insights
- Quality Assurance: Automated testing and validation
- Version Control: Git integration and workflow support
๐ Supported Platforms
- Node.js: 18.0.0 - 22.x
- Primary OS Support: macOS, Linux (optimized)
- Secondary OS Support: Windows
- Terminals: All major terminal applications
- Shells: bash, zsh (recommended), fish, PowerShell
๐ Documentation
Command Reference
- Interactive Mode:
maria(starts directly) - All Commands:
/helpwithin interactive mode - Algorithm Education:
/sort,/learn,/algorithmcommands - AI Development:
/code,/bug,/lint,/modelcommands - System Status:
/statuscommand
Examples and Tutorials
- Getting Started: Run
mariaand type/help - Algorithm Learning: Use
/sort quicksort --visualizefor interactive tutorials - Development Workflow: AI-assisted coding with
/codecommands - Performance Analysis: Built-in benchmarking with
/benchmarkcommands
๐ง Configuration
MARIA works out of the box with no configuration required. For advanced features:
# Start interactive mode (default)
maria
# Check system status
> /status
# Configure AI providers
> /model # Select from 22+ AI models (GPT, Claude, Gemini, Local LLMs)
# Algorithm education
> /sort quicksort --visualize # Interactive learning๐ค Contributing
We welcome contributions to MARIA! Please check our contribution guidelines.
Development Setup
# Clone the repository
git clone https://github.com/bonginkan/maria.git
cd maria
# Install dependencies
npm install
# Build the project
npm run build
# Run locally
./bin/maria๐ License
Dual-License Model: Personal Use (Free) / Enterprise (Paid)
- Personal Use: Free for individuals, students, and startups (<10 employees, <$1M ARR)
- Enterprise: Commercial license required for larger organizations
- Contact: enterprise@bonginkan.ai for enterprise licensing
See LICENSE for complete terms.
๐ Links
- NPM Package: npmjs.com/package/@bonginkan/maria
- GitHub Repository: github.com/bonginkan/maria
- Documentation: Available via
maria --help - Support: GitHub Issues
๐ฏ What Makes MARIA Special
Revolutionary AI Development
- First Autonomous AI: Complete software development from requirements
- Visual Progress: Beautiful CLI with real-time feedback
- Educational Focus: Algorithm learning with interactive visualization
- Professional Quality: Industry-standard engineering practices
Cutting-Edge Technology
- Advanced AI Integration: Multiple AI model support
- Intelligent Automation: Self-learning and adaptation
- Modern CLI Experience: Beautiful, responsive interface
- Cross-Platform: Works everywhere Node.js runs
Perfect for:
- Students: Learn algorithms with interactive visualization
- Developers: Accelerate development with AI assistance
- Teams: Collaborative development with autonomous agents
- Educators: Teach computer science with hands-on tools
Experience the Algorithm Education Revolution with MARIA Platform v1.6.4
๐ Start your journey: npm install -g @bonginkan/maria && maria
release/v1.6.0