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!

• Chat with AI directly within JMeter using Claude, OpenAI, or Ollama models
• 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, and Ollama models based on your preference or specific needs
• New! Embedded Claude Code terminal: run Claude Code interactively within JMeter, with full awareness of your current test plan structure.

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.

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".

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.

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

Install Claude Code from https://code.claude.com/docs/en/quickstart

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, 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.

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

1. How to Use:

   • Simply type @usage in the chat
   • The command will show usage statistics for either OpenAI or Anthropic depending on which service you're using

2. Information Provided:

   • Overall summary of total conversations and tokens used
   • Detailed breakdown of recent conversations (last 10)
   • Token usage per conversation (input and output tokens)
   • Timestamps and model information
   • Link to official pricing pages for cost information

3. Example Output:

   ``

   Usage Summary

   Overall Summary

   • Total Conversations: 5
   • Total Input Tokens: 1500
   • Total Output Tokens: 2000
   • Total Tokens: 3500

   Recent Conversations

   • Conversation 1: 300 input, 400 output tokens
   • Conversation 2: 250 input, 350 output tokens ... ``

4. Benefits:

   • Track your API usage and costs
   • Monitor token consumption patterns
   • Identify potential optimization opportunities
   • Keep track of conversation history

Use the @this command in your message to get detailed information about the currently selected element in your test plan. For example:

• "Tell me about @this element"
• "How can I optimize @this?"
• "What are the best practices for @this?"

Feather Wand will analyze the selected element and provide tailored information and advice.

Use the @optimize command (or simply type "optimize") to get optimization recommendations for the currently selected element in your test plan. This command will:

1. Analyze the selected element's configuration
2. Identify potential performance bottlenecks
3. Suggest specific, actionable improvements
4. Provide best practices for that element type

For example, if you have an HTTP Request sampler selected, the optimization recommendations might include:

• Connection and timeout settings adjustments
• Proper header management
• Efficient parameter handling
• Encoding settings optimization
• Redirect handling improvements

Simply select an element in your test plan and type @optimize or optimize in the chat to receive tailored optimization recommendations.

Use the @lint command to automatically rename elements in your test plan for better organization and readability:

1. How to Use:

   • Type @lint in the chat to analyze your test plan structure
   • The AI will suggest better names for elements based on their function and context
   • Review the suggestions and confirm to apply the changes
   • Use the undo/redo buttons to revert or reapply changes if needed
   • e.g. @lint rename the elements based on the URL or @lint rename the elements in pascal case

2. Benefits:

   • Improves test plan readability and maintenance
   • Applies consistent naming conventions across your test plan
   • Helps identify elements with generic or unclear names
   • Makes test plans more understandable for team members
   • Undo it if you don't like the changes
   • Redo it if you like the changes

3. Best Practices:

   • Run @lint after creating a new test plan to establish good naming from the start
   • Use it before sharing test plans with team members
   • Apply it to imported test plans to make them conform to your naming standards

This feature is particularly valuable for large test plans or when working in teams where consistent naming is essential for collaboration.

Use the @wrap command to intelligently group HTTP samplers under Transaction Controllers for better organization and reporting:

1. How to Use:

   • Select a Thread Group in your test plan
   • Type @wrap in the chat
   • The AI will analyze your HTTP samplers and group similar ones under Transaction Controllers
   • Use the undo button to revert changes if needed

2. Benefits:

   • Improves test plan organization and readability
   • Enhances test reports with meaningful transaction metrics
   • Groups related HTTP requests logically
   • Preserves the original order and hierarchy of samplers
   • Maintains all child elements (like assertions and post-processors) with their parent samplers

3. How It Works:

   • Analyzes sampler names and paths to identify logical groupings
   • Creates appropriately named Transaction Controllers
   • Moves samplers under their respective Transaction Controllers
   • Preserves the original order and hierarchy
   • Uses pattern matching and structural analysis (not AI) for its grouping logic

This feature is especially useful for imported or recorded test plans that contain many individual HTTP samplers without proper organization.

Feather Wand features a fully embedded interactive Claude Code Terminal using JediTerm. This allows you to interact directly with the Claude Code CLI from within JMeter, bringing agentic AI workflows into your performance testing environment.

1. Prerequisites: You must have claude-code installed globally via npm (npm install -g @anthropic-ai/claude-code).
2. Setup: Make sure to set jmeter.ai.terminal.claudecode.enabled=true in your properties file. You can also specify the executable path (jmeter.ai.terminal.claudecode.path) if it's not detected automatically in your system's PATH.
3. Capabilities:
   • Start, reload, and interact with the JMeter test plan using natural language.
   • Claude Code automatically receives the full structure/context of the currently open .jmx file.
   • You can ask Claude Code to run the test plan, parse JTL files, and more.
4. Disabling: If you do not want to use this feature, set jmeter.ai.terminal.claudecode.enabled=false. The terminal widget will gracefully start a dummy process with an instructional message.

⚠️ Disclaimer: Claude Code is a powerful AI agent that can execute commands, modify files, and consume API tokens significantly faster than standard chat interfaces. Users are strongly encouraged to thoroughly review the official Claude Code documentation to fully understand its capabilities, security considerations, and potential costs before enabling and using this feature.

Feather Wand supports Anthropic (Claude), OpenAI, and Ollama APIs. You can configure any combination in your properties file.

1. Go to Anthropic API website
2. Sign up for an account
3. Create a new API key
4. Copy the API key and paste it into the anthropic.api.key property in your jmeter.properties file
5. For more information about the API key, visit the API Key documentation

1. Go to OpenAI API website
2. Sign up for an account
3. Create a new API key
4. Copy the API key and paste it into the openai.api.key property in your jmeter.properties file
5. For more information about the API key, visit the API Key documentation

1. Install Ollama from ollama.com
2. Pull a model, e.g. ollama pull llama3.1 or ollama pull deepseek-r1:1.5b
3. Set jmeter.ai.service.type=ollama in your jmeter.properties file
4. Configure ollama.host, ollama.port, and ollama.default.model as needed
5. No API key required - Ollama runs fully locally

Feather Wand automatically filters available models to show only chat-compatible models. By default, it excludes audio, TTS, transcription, and other non-chat models. You can select your preferred model from the dropdown in the UI, or set default models in the properties file:

• For Claude: claude.default.model (e.g., claude-sonnet-4-6)
• For OpenAI: openai.default.model (e.g., gpt-4o)
• For Ollama: ollama.default.model (e.g., llama3.1, deepseek-r1:1.5b)

Feather Wand applies intelligent filtering to the available models to ensure you only see relevant chat models in the dropdown:

• OpenAI Models: Filters out audio, TTS, whisper, davinci, search, transcribe, realtime, and instruct models to show only GPT chat models.
• Claude Models: Shows only the latest available Claude models.

This filtering ensures that you only see models that are compatible with the chat interface and appropriate for JMeter-related tasks.

If you encounter any issues or have suggestions for improvement, please open an issue on the GitHub repository.

Please check the roadmap for more details.

While the Feather Wand plugin aims to provide helpful assistance, please keep the following in mind:

• AI Limitations: The AI can make mistakes or provide incorrect information. Always verify critical suggestions before implementing them in production tests.
• Backup Your Test Plans: Always backup your test plans before making significant changes, especially when implementing AI suggestions.
• Test Verification: After making changes based on AI recommendations, thoroughly verify your test plan functionality in a controlled environment before running it against production systems.
• Performance Impact: Some AI-suggested configurations may impact test performance. Monitor resource usage when implementing new configurations.
• Security Considerations: Do not share sensitive information (credentials, proprietary code, etc.) in your conversations with the AI.
• API Costs: Be aware that using the Claude API or OpenAI API incurs costs based on token usage. The plugin is designed to minimize token usage, but excessive use may result in higher costs.

This plugin is provided as a tool to assist JMeter users, but the ultimate responsibility for test plan design, implementation, and execution remains with the user.