🚀 Feather Wand - JMeter Agent

This plugin provides a simple way to chat with AI in JMeter. Feather Wand serves as your intelligent assistant for JMeter test plan development, optimization, and troubleshooting.

🪄 About the name: The name "Feather Wand" was suggested by my children who were inspired by an episode of the animated show Bluey. In the episode, a simple feather becomes a magical wand that transforms the ordinary into something special (heavy) - much like how this plugin aims to transform your JMeter experience with a touch of AI magic!

✨ Features

• Chat with AI directly within JMeter using Claude, OpenAI, Google Gemini, DeepSeek, or Ollama models
• New! Multi-AI CLI Terminal: run Claude Code, OpenAI Codex CLI, OpenCode, or Antigravity CLI interactively within JMeter — switch between available CLIs via a dropdown selector, with full awareness of your current test plan structure.
• New! Streaming AI responses: AI responses appear token-by-token in real-time (supports Claude, OpenAI, Google Gemini, DeepSeek, and Ollama)
• New! Stop button: Cancel an ongoing AI response at any time with the Stop button
• New! Response chime: Audio notification when AI responses complete (configurable)
• Get suggestions for JMeter elements based on your needs
• Ask questions about JMeter functionality and best practices
• Command intellisense with auto-completion for special commands in the chat input box
• Use @this command to get detailed information about the currently selected element
• Use @code command to extract code blocks from AI responses into the JSR223 editor
• Use @usage command to get usage examples for JMeter components
• Use @lint command to automatically rename elements in your test plan for better organization and readability
• Use @optimize command to get optimization recommendations for the currently selected element in your test plan
• Use @wrap command to intelligently group HTTP samplers under Transaction Controllers for better organization and reporting
• Use right click context menu to refactor code, format code, and add functions in JSR223 script editor
• Customize AI behavior through configuration properties
• Switch between Claude, OpenAI, Google Gemini, DeepSeek, and Ollama models based on your preference or specific needs

📥 Installation

Plugins Manager (Recommended)

1. Install the JMeter Plugins Manager from Plugins Manager.
2. Restart JMeter.
3. Launch Plugins Manager.
4. Search for feather wand under Available Plugins tab.
5. Select it and click Apply Changes and Restart JMeter button.

Manual Installation (Alternative)

1. Download the latest release JAR file from the Releases page.
2. Place the JAR file in the lib/ext directory of your JMeter installation.
3. Copy the contents of jmeter-ai-sample.properties into your jmeter.properties file (located in the bin directory of your JMeter installation) or into your user.properties file.
4. Configure your API key(s) for Anthropic and/or OpenAI in the properties file.
5. Restart JMeter.
6. The Feather Wand plugin will appear as a new component in the right-click menu under "Add" > "Non-Test Elements" > " Feather Wand".

⚙️ Configuration

The Feather Wand plugin can be configured through JMeter properties. Copy the jmeter-ai-sample.properties file content to your jmeter.properties or user.properties file and modify the properties as needed.

🔧 Available Configuration Options

Streaming Configuration

When streaming is enabled (default), AI responses appear progressively in the chat as they are generated. You can cancel the response at any time using the Stop button that appears next to the Send button. This feature is supported by all five AI services: Claude, OpenAI, Google Gemini, DeepSeek, and Ollama. If you prefer to receive the complete response at once (non-streaming), set jmeter.ai.streaming.enabled=false.

Anthropic (Claude) Configuration

OpenAI Configuration

Google Gemini Configuration

Ollama Configuration

⚠️ When ollama.thinking.mode=ENABLED, increase ollama.request.timeout.seconds to at least 300 to avoid timeout errors during long inference.

Code Refactoring Configuration

AI CLI Terminal Configuration

The AI CLI Terminal supports Claude Code, OpenAI Codex CLI, GitHub Copilot CLI, OpenCode, and * Antigravity CLI*. The plugin automatically detects which CLIs are available on your system's PATH and presents them in a dropdown selector.

Prerequisites:

💬 Customizing the System Prompt

The system prompt defines how the AI (Claude or OpenAI) responds to your queries. You can customize this in the properties file to focus on specific aspects of JMeter or add your own guidelines.

claude.system.prompt, openai.system.prompt, google.system.prompt, deepseek.system.prompt, and ollama.system.prompt can be configured separately in the properties file. The default prompts are designed to provide helpful, JMeter-specific responses tailored to each AI model's capabilities.

🔍 Special Commands

📊 @usage Command

Use the @usage command to view detailed token usage information for your AI interactions:

1. How to Use:

   • Simply type `@us