Qodana Code Inspector

This skill runs Qodana static analysis on the current project and returns parsed inspection results in an easy-to-read format. It supports all JetBrains Qodana linters for comprehensive multi-language code analysis.

When to Use

Use this skill when you need to:

Find code quality issues (unused code, redundant constructs, etc.)
Detect potential bugs and problematic code patterns
Check for JetBrains IDE inspections (IntelliJ IDEA, PyCharm, WebStorm, etc.)
Get a list of issues to fix in the codebase
Analyze code changes after modifications
Perform language-specific static analysis across your tech stack

How to Use

Basic Usage

Run full project inspection (specify the appropriate linter for your project):

# Java/Kotlin project
bash .claude/skills/qodana-inspect/scripts/run-qodana.sh --linter qodana-jvm-community

# Python project
bash .claude/skills/qodana-inspect/scripts/run-qodana.sh --linter qodana-python-community

# TypeScript/JavaScript project
bash .claude/skills/qodana-inspect/scripts/run-qodana.sh --linter qodana-js

Incremental Analysis

Analyze only changes since a specific commit:

bash .claude/skills/qodana-inspect/scripts/run-qodana.sh --linter <linter-name> --diff-start <commit-hash>

Help

View all available linters and options:

bash .claude/skills/qodana-inspect/scripts/run-qodana.sh --help

Platform Fixes (Automatic)

The skill includes automatic platform-specific fixes for known Qodana issues. These fixes are applied automatically before analysis based on the selected linter.

PyCharm/Python Platform Fix

Issue: Qodana native mode for Python may fail to create jdk.table.xml, causing it to not recognize installed libraries from virtual environments (bug QD-11375).

Automatic Fix: When using qodana-python or qodana-python-community linters, the skill:

Detects if jdk.table.xml is missing in Qodana's config directory
Extracts Python SDK configuration from .idea/misc.xml
Automatically generates jdk.table.xml with proper paths to:
- Virtual environment site-packages
- Python standard library
- Python DLLs

Result: Eliminates false positives like:

PyTypeHintsInspection errors on valid PEP 604 union types (dict | None)
PyClassHasNoInitInspection errors on @dataclass classes
Import resolution errors for installed packages

This fix is transparent and requires no user configuration. If the project has .idea/misc.xml with a configured Python SDK, the fix applies automatically.

Future Platform Fixes

The architecture supports adding fixes for other platforms:

IntelliJ IDEA (JVM projects)
WebStorm (JavaScript/TypeScript)
Rider (.NET projects)

Output Format

The script returns results grouped by file:

=== FILE: src/main/kotlin/example/Example.kt ===

[HIGH] UnusedSymbol
Location: line 45, column 13
Message: Variable 'unusedVar' is never used
Code:
val unusedVar = "test"

---

[MODERATE] NamingConvention
Location: line 52, column 9
Message: Property name should follow naming convention
Code:
private val MyProperty = "value"

=== FILE: src/main/kotlin/example/Another.kt ===
...

Severity Levels

HIGH: Important issues (unused code, potential bugs, API problems)
MODERATE: Style and convention issues
INFO: Informational notices

Available Linters

JVM Ecosystem

qodana-jvm-community - Java, Kotlin, Groovy (Community, free)
qodana-jvm - Java, Kotlin, Groovy (Ultimate, paid)
qodana-jvm-android - Android development (Community, free)
qodana-android - Android development (Ultimate, paid)

Web Development

qodana-js - JavaScript, TypeScript (Ultimate, paid)
qodana-php - PHP, JavaScript, TypeScript (Ultimate, paid)

.NET & C/C++

qodana-cdnet - C#, VB.NET (Community, free)
qodana-dotnet - C#, VB.NET, C, C++ (Ultimate, paid)
qodana-clang - C, C++ (Community, free)
qodana-cpp - C, C++ (Ultimate, paid)

Other Languages

qodana-python-community - Python (Community, free)
qodana-python - Python (Ultimate, paid)
qodana-go - Go (Ultimate, paid)
qodana-ruby - Ruby (Ultimate, paid)

Technical Details

Mode: Native (no Docker required, uses --within-docker=false)
Output: Parsed SARIF JSON format
Results location:
- Windows: ~/AppData/Local/JetBrains/Qodana/*/results/
- macOS: ~/Library/Caches/JetBrains/Qodana/*/results/
- Linux: ~/.cache/JetBrains/Qodana/*/results/

Requirements

Qodana CLI must be installed (qodana command available)
jq must be installed for JSON parsing
Appropriate linter must be specified for the project's programming language

Notes

Full scan typically takes 30 seconds to several minutes depending on project size
Incremental scan with --diff-start takes longer (analyzes two project states)
Results include exact line/column numbers and code snippets for context
Script filters out Qodana progress messages, showing only final results
Cross-platform support: Windows, macOS, Linux

Limitations

Quick-Fix auto-correction is not available in Community Edition linters
You must manually fix identified issues using Edit tool
Use code context and snippets provided in output to understand and fix problems
Ultimate linters (qodana-jvm, qodana-js, qodana-python, etc.) require a license