Hybrid Fix Model - User Guide¶

Last Updated: November 28, 2025 Version: 1.0 Applies to: All CodeSlick users (Free, Team, Enterprise)

📋 Overview¶

CodeSlick uses a Hybrid Fix Model that provides two types of code fixes:

Pattern-Based Fixes - Unlimited, instant, zero cost ✅
AI-Powered Fixes - Quota-limited, intelligent, uses AI 🤖

This document explains how both work, when to use each, and how quotas apply.

🎯 Two Types of Fixes¶

1️⃣ Pattern-Based Fixes (Unlimited)¶

What they are: - Deterministic pattern matching (no AI involved) - Fix syntax errors like missing semicolons, brackets, parentheses - Convert old syntax (var → const) - Fix unclosed strings

How to use: - WebTool: Click "Fix All Syntax Issues" button - GitHub App: Automatic suggestions for syntax errors

Examples of what they fix:

// Missing semicolon
console.log("Hello")  → console.log("Hello");

// Unclosed bracket
if (x > 0) {
  return true;
// Missing }

// Old syntax
var x = 5;  → const x = 5;

// Unclosed string
const name = "John;  → const name = "John";

Characteristics: - ⚡ Speed: <100ms (instant) - 💰 Cost: Free (no API calls) - 📊 Quota: Unlimited ✅ - 🎯 Accuracy: 100% (deterministic)

2️⃣ AI-Powered Fixes (Quota-Limited)¶

What they are: - Intelligent fixes powered by Claude Sonnet 3.5 - Fix security vulnerabilities (SQL injection, XSS, etc.) - Complex refactoring and logic improvements - Context-aware code transformations

How to use: - WebTool: Click "Generate Fix" button (per issue) - GitHub App: Click "Apply Fix" button (per issue)

Examples of what they fix:

// SQL Injection vulnerability
const query = `SELECT * FROM users WHERE id = ${userId}`;
// → AI suggests parameterized queries

// XSS vulnerability
element.innerHTML = userInput;
// → AI suggests DOMPurify or textContent

// Hardcoded secrets
const apiKey = "sk-abc123...";
// → AI suggests environment variables

// Complex logic issues
// → AI provides context-aware refactoring

Characteristics: - ⚡ Speed: 5-30 seconds per fix - 💰 Cost: Uses server AI credits (Claude API) - 📊 Quota: Limited by plan (see below) - 🎯 Accuracy: Very high (AI-powered)

📊 Quota System¶

Free Plan¶

✅ 20 PR analyses per month
✅ Unlimited pattern-based fixes
⚠️ 30 AI fixes per month

What happens when you hit the limit?

You've reached your free plan limit (30 AI fixes/month).

Options:
1. Upgrade to Team plan (150 AI fixes/month) → €99/month
2. Add your API key for unlimited AI fixes → Free forever
3. Wait until next month (quota resets on the 1st)

Team Plan (€99/month)¶

✅ Unlimited PR analyses
✅ Unlimited pattern-based fixes
⚠️ 150 AI fixes per month

Perfect for teams with moderate AI fix needs. Most teams use 30-80 AI fixes/month.

Enterprise Plan (€299/month)¶

✅ Unlimited PR analyses
✅ Unlimited pattern-based fixes
✅ Unlimited AI fixes ⭐

No restrictions. Ideal for large teams with heavy usage.

🔑 Unlimited AI Fixes (Free Forever)¶

Want unlimited AI fixes without upgrading? Provide your own API key!

Supported Providers (OpenAI-Compatible APIs):¶

✅ OpenRouter (100+ models) - Recommended ⭐
✅ OpenAI (GPT-4o, GPT-3.5)
✅ Anthropic (Claude 3.5 Sonnet)
✅ Groq (Fast inference)
✅ Google (Gemini)
✅ Self-hosted (Ollama, LM Studio, vLLM)

How to Configure Your API Key:¶

WebTool:¶

Click "API Key Settings" in the top toolbar
Select your provider (e.g., OpenRouter)
Enter your API key
Click "Save"
Done! Unlimited AI fixes ✅

GitHub App:¶

Go to Team Settings → API Configuration
Select provider
Enter API key
Save
All team members now have unlimited AI fixes ✅

Cost: You pay for API usage (~$0.02 per AI fix). With 100 fixes, that's ~$2/month.

🤔 Which Fix Type Should I Use?¶

Use Pattern-Based Fixes When:¶

✅ Fixing syntax errors (missing semicolons, brackets)
✅ Quick bulk fixes (Fix All Syntax Issues)
✅ You want instant results (<100ms)
✅ No quota concerns (unlimited)

Use AI-Powered Fixes When:¶

✅ Fixing security vulnerabilities
✅ Complex refactoring
✅ Need context-aware suggestions
✅ Logic improvements beyond syntax

Hybrid Workflow (Recommended):¶

1. Run PR analysis → Identifies 20 issues
2. Click "Fix All Syntax Issues" → Fixes 10 syntax errors (instant, unlimited)
3. Review remaining 10 security issues
4. Click "Apply Fix" on critical issues → Uses AI quota (10 AI fixes)
5. Result: 20 issues fixed, only 10 AI fixes used

Pro Tip: Always use pattern-based fixes first to save AI quota for complex issues!

📈 Monitoring Your Quota¶

WebTool:¶

Check the "Usage Dashboard" for current quota
Shows: "X/30 AI fixes used this month"

GitHub App:¶

View Team Dashboard → Quota Section
Shows: "X/150 AI fixes used this month"
Admins can see detailed usage breakdown

Quota Reset:¶

Resets on the 1^st of every month (00:00 UTC)
Example: Used 30/30 on Oct 31 → Resets to 0/30 on Nov 1

❓ Frequently Asked Questions¶

Q: Can I really get unlimited fixes on the free plan?¶

A: Yes! Pattern-based fixes are unlimited for everyone. AI fixes are limited to 30/month, but you can bypass this by providing your own API key (free forever).

Q: What if I need 31 AI fixes in one month on the free plan?¶

A: You have three options: 1. Upgrade to Team plan (€99/month, 150 AI fixes) 2. Add your API key (unlimited, you pay for API usage ~$0.02/fix) 3. Wait until next month (quota resets on the 1^st)

Q: Do pattern-based fixes work for security issues?¶

A: No. Pattern fixes only handle syntax errors. Security vulnerabilities require AI-powered fixes.

Q: How much does it cost to use my own API key?¶

A: Approximately $0.02 per AI fix. For 100 AI fixes, that's ~$2/month paid directly to your API provider (e.g., OpenRouter, OpenAI).

Q: Can I mix pattern and AI fixes in one session?¶

A: Absolutely! Use "Fix All Syntax Issues" first (unlimited), then "Apply Fix" for remaining issues (uses AI quota). This is the recommended workflow.

Q: What happens if I exceed my quota mid-fix?¶

A: The fix will not be applied, and you'll see a message explaining your options (upgrade, add API key, or wait).

Q: Can I see how many AI fixes I've used?¶

A: Yes! Check your Dashboard → Usage section. Shows used/remaining quota and reset date.

Q: Do AI fixes consume quota even if they fail?¶

A: No. Only successful AI fixes count toward your quota.

🎓 Best Practices¶

1. Use Pattern Fixes First¶

Always run "Fix All Syntax Issues" before using AI fixes. This is free, instant, and saves your AI quota.

2. Batch Critical Issues¶

Don't fix every issue with AI. Focus on CRITICAL and HIGH severity issues. Let pattern fixes handle the rest.

3. Monitor Your Quota¶

Check your dashboard regularly. If you're consistently hitting limits, consider: - Upgrading to Team plan - Adding your API key - Optimizing which issues you fix with AI

4. Provide Your API Key (Power Users)¶

If you fix 50+ issues per month, it's cheaper to use your own API key: - 50 AI fixes with own key: ~$1/month - Team plan: €99/month

5. Educate Your Team¶

Make sure team members understand the difference between pattern and AI fixes to optimize quota usage.

📞 Need Help?¶

Email: support@codeslick.dev Docs: https://codeslick.dev/help Status: Check https://codeslick.dev/status for service updates

📝 Summary Table¶

Feature	Pattern Fixes	AI Fixes
Speed	<100ms (instant)	5-30 seconds
Technology	Pattern matching	Claude Sonnet 3.5
Use Cases	Syntax errors	Security vulnerabilities
Quota (Free)	Unlimited ✅	30/month
Quota (Team)	Unlimited ✅	150/month
Quota (Enterprise)	Unlimited ✅	Unlimited ✅
Own API Key	N/A	Unlimited ✅
Cost (Server)	$0	~$0.02/fix
Cost (Own Key)	$0	~$0.02/fix

Version History: - v1.0 (Nov 28, 2025): Initial Hybrid Model documentation