DevoxxGenieIDEAPlugin: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

DevoxxGenie is a Java-based LLM Code Assistant plugin for IntelliJ IDEA that integrates with both local LLM providers ( Ollama, LMStudio, GPT4All, Llama.cpp, Exo) and cloud-based LLMs (OpenAI, Anthropic, Mistral, Groq, Gemini, DeepInfra, DeepSeek, OpenRouter, Azure OpenAI, Amazon Bedrock). The plugin supports advanced features like RAG (Retrieval-Augmented Generation), MCP (Model Context Protocol) servers, web search, and agentic programming capabilities.

Threading Constraints

This is a JetBrains/IntelliJ plugin. UI operations must run on the EDT (Event Dispatch Thread), and long-running operations must NOT block it. Use ApplicationManager.getApplication().invokeLater() or ReadAction/WriteAction as appropriate.

Workflow Rules

When asked to investigate or fix an issue, do NOT deeply explore the entire codebase autonomously. Start focused on the specific area mentioned, and ask before expanding scope. Avoid unnecessary web searches unless explicitly requested.

Git Workflow

Always create a feature/fix branch BEFORE making any code changes. Never edit code on the current branch without confirming the branch strategy first. Feature/fix branches for issues are cut from develop (e.g. fix/issue-1234).

Testing

When asked to investigate a bug, write a reproducing test FIRST — confirm it fails — before applying any fix, unless told otherwise.

Build & Development Commands

Java Version Requirement

IMPORTANT: This project requires JDK 21 for building. JDK 25 causes Gradle build script failures. Always set JAVA_HOME before running Gradle commands:

export JAVA_HOME=~/.sdkman/candidates/java/21-zulu

Testing

IMPORTANT: Always pipe test output to grep for failures so you can immediately focus on what failed:

./gradlew test 2>&1 | grep -E "FAILED|failed"
./gradlew test --tests ClassName 2>&1 | grep -E "FAILED|failed"
./gradlew test --tests ClassName.methodName 2>&1 | grep -E "FAILED|failed"
./gradlew verifyPlugin                            # Verify plugin (includes tests)