<div align="center">

👑 CYRUS

The Code Empire Analyzer

AI-Powered Code Analysis, Debugging & Language Detection CLI for Modern Developers

🚀 Quick Start • 📖 Documentation • 🤖 AI Providers • 🔍 Language Detection • ⚙️ Configuration

</div>

---

✨ What Makes Cyrus Special?

Cyrus isn't just another code analysis tool, it's your AI-powered code empire command center. Built for the modern developer workflow, it combines cutting-edge language detection, multiple AI provider support, and comprehensive code analysis in one elegant CLI.

🏆 Key Highlights

• 🎯 High-Precision Language Detection - 95%+ accuracy with confidence scoring
• 🤖 Multiple AI Providers - OpenAI, Anthropic, Google, X.AI + Local AI support
• 🌐 10+ Programming Languages - From JavaScript to Rust, we've got you covered
• 🏠 Local AI Support - Ollama, LM Studio, and custom OpenAI-compatible APIs
• 📊 Framework Detection - React, Vue, Django, Spring, and 20+ more
• ⚡ Lightning Fast - Built with Bun for maximum performance
• 🎨 Beautiful CLI - Claude Code-inspired UX with progress indicators

---

🌟 Features

<details> <summary><strong>🔍 Advanced Language Detection</strong></summary>

• Multi-layered Detection: File extensions + content analysis + pattern matching
• Framework Recognition: Automatically detects React, Vue, Django, Flask, Spring, etc.
• Build Tool Detection: npm, yarn, pnpm, bun, pip, poetry, cargo, maven, gradle
• Test Framework Identification: Jest, pytest, JUnit, Mocha, RSpec, and more
• Confidence Scoring: Get percentage confidence for each detection
• Project-wide Analysis: Scan entire codebases with language distribution

# Detect languages in current project
cyrus detect .

# Analyze a specific file with detailed info
cyrus detect src/components/App.tsx --detailed

# Export project language analysis
cyrus detect . --json -o project-analysis.json

</details> <details> <summary><strong>🤖 Multi-AI Provider Support</strong></summary>

Cloud Providers:

• OpenAI: GPT-4, GPT-4 Turbo, GPT-3.5 Turbo
• Anthropic: Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku
• Google: Gemini 1.5 Pro, Gemini 1.5 Flash
• X.AI: Grok Beta

Local AI Providers:

• Ollama: Auto-detection of installed models
• LM Studio: Seamless integration with local models
• Custom APIs: Any OpenAI-compatible local server

# Setup with local AI (no API key required!)
cyrus config init
# ✓ Found local AI models:
#   Ollama: llama3.2, codellama, mistral
#   LM Studio: deepseek-coder, code-llama-13b

# Switch between providers easily
cyrus config set provider ollama
cyrus config set model llama3.2

</details> <details> <summary><strong>📊 Comprehensive Code Analysis</strong></summary>

• Static Analysis: Syntax errors, code quality, complexity metrics
• Security Scanning: OWASP vulnerability detection with severity levels
• Performance Analysis: Bottleneck identification and optimization suggestions
• AI-Powered Insights: Contextual explanations and improvement recommendations
• Multiple Output Formats: Text, JSON, Markdown for any workflow

# Full analysis suite
cyrus analyze src/app.ts --security --metrics --explain

# Quick fix for critical issues
cyrus fix src/problematic-file.js

# Comprehensive code review
cyrus review src/components/UserAuth.tsx

</details> <details> <summary><strong>🎓 AI-Powered Mentoring</strong></summary>

• Adaptive Learning: Personalized guidance based on your skill level
• Interactive Sessions: Ask questions, get explanations, learn patterns
• Context-Aware Teaching: Focused learning areas and customization
• Best Practices: Industry standards and coding conventions
• Code Walkthroughes: Line-by-line explanations with educational context

# Get personalized mentoring
cyrus mentor src/algorithm.js --interactive

# Learning mode with detailed explanations
cyrus learn src/complex-component.tsx

</details> <details> <summary><strong>⚡ Smart Code Generation</strong></summary>

• Test Generation: Comprehensive unit tests with edge cases and mocking
• Documentation: JSDoc, docstrings, README generation
• Refactoring Suggestions: Before/after examples with detailed explanations
• Project Scaffolding: Complete project structures from descriptions
• Component Generation: Framework-specific components (React, Vue, Angular)

# Generate comprehensive tests
cyrus generate tests src/utils/validator.js

# Create documentation
cyrus generate docs src/api/

# Get refactoring suggestions
cyrus generate refactor src/legacy-code.js --interactive

# Generate entire project
cyrus generate project "REST API with TypeScript and Prisma"

</details> <details> <summary><strong>🏥 Proactive Health Monitoring</strong></summary>

• Codebase Health Reports: Overall score with actionable insights
• Technical Debt Tracking: Quantified debt with time estimates
• Maintainability Index: Industry-standard metrics and trends
• Historical Analysis: Track improvements over time
• Team Reporting: Export reports for team reviews

# Scan entire codebase health
cyrus health

# Detailed health report with trends
cyrus health --detailed --save

# Parallel processing for large codebases
cyrus health --parallel --output health-report.json

</details> <details> <summary><strong>🎯 Code Quality Scoring</strong></summary>

• Comprehensive Quality Score: Overall grade (A+ to F) based on multiple factors
• Weighted Metrics: Code health, maintainability, complexity, test coverage, documentation, security
• AI-Powered Recommendations: Specific, actionable improvement suggestions
• File-Level Analysis: Identify files needing the most attention
• Progress Tracking: Monitor quality improvements over time

# Calculate quality score for entire project
cyrus quality .

# Quality score for specific file
cyrus quality src/components/UserAuth.tsx

# Analyze with custom limits
cyrus quality . --max-files 100

# Export quality report
cyrus quality . --json > quality-report.json

Sample Output:

🎯 Code Quality Report
═══════════════════════════════════════════════════════════

Overall Quality Score: 87/100 (A)
████████████████████░

📊 Detailed Metrics:
  Code Health      92/100 ██████████
  Maintainability  85/100 ████████▌░
  Complexity       78/100 ███████▌░░
  Test Coverage    95/100 █████████▌
  Documentation    72/100 ███████▍░░
  Security         94/100 █████████▍

🚀 Improvement Recommendations:
• Reduce complexity in high-complexity functions (complexity.js:45-67)
• Add inline documentation for public APIs
• Consider extracting utility functions for better maintainability
• Review security practices in authentication modules

</details> <details> <summary><strong>🔄 Smart Code Comparison</strong></summary>

• Side-by-Side Comparison: Visual diff with line-by-line and word-by-word modes
• AI-Powered Analysis: Deep insights into similarities, differences, and improvements
• Security & Performance Impact: Understand the implications of code changes
• Detailed Metrics: Code size, complexity, and quality comparisons
• Flexible Input: Compare files, code snippets, or even different versions

# Compare two code files
cyrus compare old.js new.js

# Word-by-word comparison
cyrus compare file1.py file2.py --words

# Detailed comparison with metrics
cyrus compare v1.ts v2.ts --detailed

# Include security analysis
cyrus compare auth-old.js auth-new.js --security

# Compare code snippets directly
cyrus compare "function old() { return 1; }" "const new = () => 1;"

# Export comparison report
cyrus compare src/v1/ src/v2/ --json > comparison-report.json

Sample Output:

🔍 Code Comparison: old.js vs new.js
═══════════════════════════════════════════════════════════

📋 Line-by-line Comparison:
────────────────────────────────────────────────────────────
-   1 │ function calculateTotal(items) {
+   1 │ const calculateTotal = (items) => {
    2 │   let total = 0;
-   3 │   for (let i = 0; i < items.length; i++) {
-   4 │     total += items[i].price;
+   3 │   return items.reduce((sum, item) => sum + item.price, 0);
-   5 │   }
-   6 │   return total;
    7 │ }

🤖 AI-Powered Comparison Analysis

🔗 Key Similarities
• Both functions calculate the total price of items
• Same input parameter structure and expected output
• Both handle array iteration for summation

🔄 Key Differences  
• Modern ES6 arrow function syntax vs traditional function declaration
• Functional programming approach (reduce) vs imperative loop
• More concise implementation reduces code by 60%
• Better immutability practices in the new version

🚀 Improvements & Recommendations
• New version is more functional and concise
• Arrow function with reduce is more expressive
• Better performance with native reduce method
• Consider adding TypeScript for better type safety

🔒 Security Implications
• No security implications identified in this change
• Both versions handle input validation equally

⚡ Performance Notes
• New version likely faster due to native reduce optimization
• Reduced memory allocation with functional