Fixora AI
Find Bugs. Understand Errors. Fix Code. Build Better.
Overview
Fixora AI is an all-in-one developer productivity powerhouse for Visual Studio Code. It integrates real-time inline diagnostics, live code complexity metrics, as-you-type multi-language linting, automated Prettier formatting with silent syntax healing, and context-aware AI review into a unified, lightweight extension.
With Fixora AI, you no longer need multiple disjointed extensions for formatting, linting, complexity inspection, and error highlighting. Everything works out of the box with zero external dependencies.
Core Pillars & Features
1. ⚡ Built-In Error Lens (Inline Diagnostics)
- Inline Highlighting: Diagnostic messages (errors, warnings, hints) render immediately at the end of the problematic line with clear icons.
- Line Highlighting: Subtly colors the background of lines containing issues to make bugs immediately visible.
- Status Bar & Quick Jump: Displays total issue counts in the status bar with rapid navigation shortcuts (
Alt+F8 to jump to the next diagnostic, Shift+Alt+F8 to jump to the previous one, and Alt+E to toggle the lens).
2. 🧠 Code Complexity Lens & Offline Refactoring
- Right-Side Metrics: Calculates cyclomatic complexity for every function as you type and displays a rating badge directly on the right side of the function declaration:
⚡ CC: 1-5 (Clean) — Green
⚡ CC: 6-10 (Moderate) — Yellow
⚡ CC: >10 (High Complexity) — Red
- Interactive Hover Cards: Hover over any function badge to inspect decision points, maintainability index, and preview recommended refactored code.
- 1-Click Offline Refactoring (
Ctrl+.): Provides automated low-complexity alternative implementations (guard clauses, early returns, and lookup table dispatch) that can be applied instantly via VS Code's lightbulb without requiring network access.
3. 🔍 Real-Time Multi-Language Linter (As-You-Type)
- Continuous Validation: Inspects your code as you type across JavaScript, TypeScript, Python, HTML, and CSS:
- JavaScript / TypeScript: Catches loose equalities (
eqeqeq), obsolete var declarations (no-var), debuggers (no-debugger), console calls in production (no-console), accidental condition assignments (no-cond-assign), and unbalanced brackets/braces.
- Python: Enforces PEP 8 rules including missing colons
: after compound statements, comparison with None (is None vs == None), boolean comparisons, and bare except: clauses.
- HTML: Detects missing
alt attributes on <img> tags, deprecated HTML5 elements (<center>, <font>, <marquee>), unclosed tags, and mismatched closing tags.
- CSS / SCSS: Flags missing semicolons, unnecessary zero units (
0px $\rightarrow$ 0), missing dimension units on non-zero lengths, and duplicate properties within declaration blocks.
- Instant QuickFixes: Press
Ctrl+. on any highlighted issue to trigger an automatic 1-click correction.
- Full Prettier Integration: Formats JavaScript, TypeScript, JSON, CSS, SCSS, HTML, Markdown, and YAML using Prettier directly inside the extension.
- Syntax Auto-Healer: When saving or executing code with minor syntax flaws (unclosed brackets, missing tags, or stray trailing characters), Fixora AI repairs the syntax automatically and silently without throwing modal error dialogs.
5. 🤖 AI Code Reviewer & Debugging Assistant
- Flexible Scope: Audit selected code snippets, active files, staged Git diffs, or entire project workspaces.
- Multiple AI Providers: Seamlessly switch between Google Gemini (
gemini-2.5-flash, gemini-2.5-pro) and local offline models via Ollama.
- 7-Question Error Explanations: Select any runtime exception or terminal error to understand:
- What happened?
- Why did it happen?
- Where is the exact location?
- What is the root cause?
- What is the recommended fix?
- How can you prevent this in the future?
- Educational concept notes for junior developers.
- Side-by-Side Diff Previews: Inspect all suggested AI edits in a native VS Code diff tab before confirming changes.
The Fixora AI sidebar in your Activity Bar provides direct access to all extension functions:
┌──────────────────────────────────────────────┐
│ Fixora AI │
│ Find Bugs. Understand Errors. Fix Code. │
├──────────────────────────────────────────────┤
│ Live Editor Features │
│ ⚡ Error Lens [ ON | OFF ] │
│ 🧠 Code Complexity Lens [ ON | OFF ] │
│ 🔍 Real-time Linter [ ON | OFF ] │
│ ✨ Prettier Formatter [ ON | OFF ] │
│ │
│ [ Format Document ] [ Complexity Audit ] │
├──────────────────────────────────────────────┤
│ AI Actions & Security │
│ • Review Selected Code │
│ • Review Current File │
│ • Security Scan (OWASP Top 10) │
│ • Review Workspace │
│ • Review Git Changes │
│ • Install Git Pre-Commit Guard │
│ • Export HTML Audit Report │
└──────────────────────────────────────────────┘
All 4 feature switches are enabled by default upon installation and persist their states across editor sessions.
Quick Start (3 Steps)
Step 1: Install Fixora AI
Install from the VS Code Marketplace or run the command line:
code --install-extension FixoraFoundation.fixora-ai
Error Lens, Code Complexity Lens, Linter, and Prettier Formatter run 100% offline without any API key.
To activate AI-driven reviews and explanations:
- Obtain a free key from Google AI Studio.
- Press
Ctrl+Shift+P (or Cmd+Shift+P on macOS) and run Fixora AI: Configure Gemini API Key.
- Paste your key. It is stored securely in your OS keychain via VS Code
SecretStorage.
Step 3: Start Coding
Open any supported file (.js, .ts, .py, .html, .css). Live diagnostics, complexity badges, and formatting will activate automatically as you type.
Command Reference
| Command Title |
Identifier |
Default Keybinding |
| Review Selected Code |
fixora.reviewSelection |
Ctrl+Alt+R (Cmd+Alt+R) |
| Review Current File |
fixora.reviewFile |
— |
| Review Workspace |
fixora.reviewWorkspace |
— |
| Review Git Changes |
fixora.reviewGit |
— |
| Review Staged Changes |
fixora.reviewStaged |
— |
| Explain Selected Error |
fixora.explainError |
Ctrl+Alt+E (Cmd+Alt+E) |
| Explain Terminal Error |
fixora.explainTerminal |
— |
| Run Security Scan |
fixora.securityScan |
— |
| Review Performance |
fixora.performanceReview |
— |
| Analyze Code Complexity |
fixora.analyzeComplexity |
— |
| Toggle Error Lens |
fixora.toggleInlineDiagnostics |
Alt+E (Cmd+E) |
| Jump to Next Diagnostic |
fixora.nextDiagnostic |
Alt+F8 |
| Jump to Previous Diagnostic |
fixora.previousDiagnostic |
Shift+Alt+F8 |
| Toggle Complexity Lens |
fixora.toggleComplexityLens |
— |
| Toggle Prettier Formatter |
fixora.toggleFormatter |
— |
| Toggle Real-time Linter |
fixora.toggleLinter |
— |
| Format Document |
fixora.formatDocument |
Shift+Alt+F |
| Format Selection |
fixora.formatSelection |
Ctrl+K Ctrl+F |
| Export HTML Report |
fixora.exportReport |
— |
| Install Git Pre-Commit Guard |
fixora.installGitHook |
— |
| Configure API Key |
fixora.configureApiKey |
— |
| Clear Diagnostics |
fixora.clearDiagnostics |
— |
Extension Settings
All settings can be configured under Settings > Extensions > Fixora AI:
| Setting ID |
Default |
Description |
fixora.errorLens.enabled |
true |
Enable live inline diagnostics and line highlighting. |
fixora.errorLens.highlightLine |
true |
Highlight background of lines with diagnostic issues. |
fixora.errorLens.showInlineMessage |
true |
Render diagnostic messages inline after the line text. |
fixora.errorLens.showStatusBar |
true |
Show diagnostic counts in the status bar with navigation. |
fixora.complexityLens.enabled |
true |
Display cyclomatic complexity metrics on the right side of code. |
fixora.linter.enabled |
true |
Enable as-you-type syntax and style linting for JS, TS, HTML, CSS, Python. |
fixora.formatter.enabled |
true |
Enable built-in Prettier formatter and silent syntax healing. |
fixora.formatter.tabWidth |
2 |
Number of spaces per indentation level. |
fixora.formatter.semi |
true |
Print semicolons at the ends of statements. |
fixora.formatter.singleQuote |
true |
Use single quotes in JavaScript/TypeScript. |
fixora.model |
"gemini-2.5-flash" |
Gemini model used for reviews and explanations. |
fixora.enableLearningMode |
false |
Deliver educational conceptual notes in findings. |
fixora.autoRedactSecrets |
true |
Mask API keys and credentials locally before sending code to AI. |
Security & Privacy Guarantee
- Zero Tracking: Fixora AI contains no tracking scripts, telemetry collectors, or usage beacons.
- Client-Side Secret Masking: Before any code leaves your computer for an AI review, regex scanners redact API tokens, private keys, AWS credentials, and database passwords into
[REDACTED_SECRET].
- Encrypted Credentials: Gemini API keys are never stored in plaintext configuration files; they reside in VS Code's OS-level
SecretStorage.
- Offline Core: The Error Lens, Complexity Analyzer, Real-time Linter, and Prettier Formatter operate 100% locally on your machine with zero external network calls.
License
Fixora AI is open-source software licensed under the MIT License.
| |