AI Code Quality Guard

🤖 Automatically analyze and refactor complex Python code with AI-powered suggestions

AI Code Quality Guard is a powerful VS Code extension that helps you write better Python code by analyzing complexity in real-time and providing intelligent refactoring suggestions powered by Claude AI.

Demo

✨ Features

🎯 Real-Time Complexity Analysis

Analyze your Python code as you type with instant visual feedback:

Cyclomatic complexity calculation for every function
Color-coded decorations (green/yellow/red) based on complexity levels
Gutter icons showing complexity at a glance
Hover tooltips with detailed breakdown

Real-time Analysis

💡 Smart Code Actions (Light Bulb)

Get intelligent quick fixes right where you need them:

💡 Show Refactoring Suggestions - View AI-powered recommendations
📊 View Complexity Breakdown - See detailed decision points
🚫 Ignore This Warning - Add ignore comments
⚙️ Configure Threshold - Adjust complexity limits

Code Actions

🤖 AI-Powered Auto-Refactoring

Let Claude AI automatically refactor your complex code:

One-click refactoring with Claude 3.5 Sonnet
Side-by-side diff view to review changes
Safety validation ensures code correctness
Complexity verification guarantees improvement

AI Refactoring

📊 Problems Panel Integration

See all complexity issues in one place:

Warning/Error severity based on thresholds
Click to navigate to problematic functions
Quick fixes available from problems panel

Suggestion Panel

🚀 Installation

From VS Code Marketplace

Open VS Code
Go to Extensions (Ctrl+Shift+X)
Search for "AI Code Quality Guard"
Click Install

Install Python Package

The extension requires the codecomplexity Python package:

pip install codecomplexity

Optional: Set Up AI Refactoring

For AI-powered auto-refactoring, you'll need a Claude API key:

Get an API key from Anthropic Console
Add to VS Code settings: codecomplexity.apiKey
Or set environment variable: ANTHROPIC_API_KEY

📋 Requirements

VS Code 1.80.0 or higher
Python 3.8 or higher
codecomplexity Python package
Claude API key (optional, only for AI refactoring)

🎯 Quick Start

1. Open a Python File

Open any Python file in VS Code. The extension activates automatically!

2. See Complexity Analysis

Save the file (Ctrl+S) to trigger analysis. You'll see:

Colored decorations on complex functions
Complexity scores in the gutter
Issues in the Problems panel

3. Use Code Actions

Click on a complex function and look for the 💡 light bulb:

Click the light bulb or press Ctrl+.
Select an action to improve your code

4. Try AI Refactoring (Optional)

If you have an API key configured:

Click "Auto-Refactor with AI"
Review the changes in the diff view
Accept or reject the refactoring

⚙️ Configuration

Access settings via Ctrl+, and search for "codecomplexity":

Basic Settings

Setting	Default	Description
`codecomplexity.pythonPath`	`"python"`	Path to Python interpreter
`codecomplexity.warningThreshold`	`8`	Complexity warning level
`codecomplexity.criticalThreshold`	`15`	Complexity error level
`codecomplexity.enableRealtime`	`true`	Enable real-time analysis

AI Settings (Optional)

Setting	Default	Description
`codecomplexity.apiKey`	`""`	Claude API key
`codecomplexity.aiModel`	`"claude-3-5-sonnet-20241022"`	AI model to use
`codecomplexity.maxTokens`	`4000`	Max tokens per request
`codecomplexity.confirmBeforeRefactor`	`true`	Ask before API calls

Example Configuration

{
  "codecomplexity.pythonPath": "python3",
  "codecomplexity.warningThreshold": 10,
  "codecomplexity.criticalThreshold": 20,
  "codecomplexity.enableRealtime": true,
  "codecomplexity.apiKey": "sk-ant-..."
}

📖 Understanding Complexity

Cyclomatic complexity measures the number of independent paths through code:

Complexity	Rating	Recommendation
1-5	✅ Simple	Low risk, easy to test
6-10	🟡 Moderate	Medium risk, consider simplifying
11-20	🟠 Complex	High risk, refactoring recommended
21+	🔴 Very Complex	Very high risk, refactor immediately

What Increases Complexity?

Each of these adds +1 to complexity:

if, elif statements
for, while loops
and, or operators
try, except blocks
with statements
Ternary operators
Comprehensions with conditions

💡 Usage Examples

Example 1: Identify Complex Functions

Before (Complexity: 12):

def process_order(order, user, config):
    if order is not None:
        if user.is_authenticated:
            if order.status == 'pending':
                if config.auto_approve:
                    if order.total < config.limit:
                        return approve_order(order)
    return None

The extension shows:

🟡 Yellow decoration
Hover: "Complexity: 12 - Consider refactoring"
Light bulb with suggestions

Example 2: AI Refactoring

After AI Refactoring (Complexity: 4):

def process_order(order, user, config):
    """Process order with validation."""
    if not _can_process_order(order, user, config):
        return None
    return approve_order(order)

def _can_process_order(order, user, config):
    """Check if order can be processed."""
    if order is None or not user.is_authenticated:
        return False
    if order.status != 'pending':
        return False
    return config.auto_approve and order.total < config.limit

Result: 67% complexity reduction! ✨

Example 3: Ignore Warnings

# codecomplexity: ignore
def legacy_function():
    # Complex but can't refactor yet
    ...

🔧 Commands

Access via Command Palette (Ctrl+Shift+P):

AI Code Quality Guard: Analyze current file - Run full analysis
AI Code Quality Guard: Get refactoring suggestions - Show suggestions

🐛 Troubleshooting

Extension Not Activating

Problem: Extension doesn't start when opening Python files

Solution:

Check Python is installed: python --version
Reload VS Code: Ctrl+Shift+P → "Reload Window"
Check Output panel: View → Output → "AI Code Quality Guard"

Python Package Not Found

Problem: "codecomplexity package not installed"

Solution:

pip install codecomplexity
# or
pip install --user codecomplexity

Decorations Not Showing

Problem: No colored highlights on functions

Solution:

Save the file (Ctrl+S)
Check file is saved as .py
Check codecomplexity.enableRealtime is true
Check Output panel for errors

AI Refactoring Not Working

Problem: "API key not configured"

Solution:

Get API key from https://console.anthropic.com/
Add to settings: codecomplexity.apiKey
Or set environment variable: ANTHROPIC_API_KEY

❓ FAQ

Q: Does this work with other languages?
A: Currently Python only. Other languages may be added in future versions.

Q: How much does AI refactoring cost?
A: Typically $0.01-0.05 per function using Claude 3.5 Sonnet.

Q: Can I use this without the API key?
A: Yes! All features work except AI auto-refactoring. You still get analysis, decorations, and manual suggestions.

Q: Is my code sent to the cloud?
A: Only when using AI refactoring. Regular analysis runs locally.

Q: How accurate is the complexity calculation?
A: Very accurate - uses AST parsing, same method as professional tools.

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Development Setup

# Clone repository
git clone https://github.com/yourusername/codecomplexity.git
cd codecomplexity/codecomplexity-vscode

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Run extension
# Press F5 in VS Code

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Anthropic for Claude AI
VS Code team for excellent extension API
Python community for inspiration

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: Full Documentation

🗺️ Roadmap

[ ] Support for more languages (JavaScript, TypeScript, Java)
[ ] Team dashboards for complexity tracking
[ ] Historical complexity trends
[ ] Custom pattern detection
[ ] Integration with CI/CD pipelines

Made with ❤️ by developers, for developers

⭐ Star on GitHub | 📦 VS Code Marketplace | 📖 Documentation

AI Code Quality Guard

Kishan Dewasi

AI Code Quality Guard

✨ Features

🎯 Real-Time Complexity Analysis

💡 Smart Code Actions (Light Bulb)

🤖 AI-Powered Auto-Refactoring

📊 Problems Panel Integration

🚀 Installation

From VS Code Marketplace

Install Python Package

Optional: Set Up AI Refactoring

📋 Requirements

🎯 Quick Start

1. Open a Python File

2. See Complexity Analysis

3. Use Code Actions

4. Try AI Refactoring (Optional)

⚙️ Configuration

Basic Settings

AI Settings (Optional)

Example Configuration

📖 Understanding Complexity

What Increases Complexity?

💡 Usage Examples

Example 1: Identify Complex Functions

Example 2: AI Refactoring

Example 3: Ignore Warnings

🔧 Commands

🐛 Troubleshooting

Extension Not Activating

Python Package Not Found

Decorations Not Showing

AI Refactoring Not Working

❓ FAQ

🤝 Contributing

Development Setup

📄 License

🙏 Acknowledgments

📞 Support

🗺️ Roadmap