AI-POWERED INTELLIGENCE FOR APACHE JMETER

Feather Wand

The AI Agent for Apache JMeter

Feather Wand is a full AI agent living inside Apache JMeter. Chat with 8 LLM providers (Claude, OpenAI, Gemini, DeepSeek, Ollama, Grok, Meta Muse, and AWS Bedrock) or enable Agent Mode and let the AI autonomously edit your test plan through 18 tools: adding elements, setting properties, running tests, and auto-correlating dynamic values. Embedded AI CLI terminals, context-aware @commands, streaming responses, and smart JSR223 refactoring included.

900+ INSTALLS

Trusted by 900+ performance engineering teams worldwide

Installed via JMeter Plugins Manager across CI/CD pipelines, QA labs, and production environments.

Install now →

AI AGENT OPEN SOURCE · MIT AGENT MODE 8 LLM PROVIDERS

Intelligent Features

Supercharge your performance testing workflow with AI-driven capabilities built natively into JMeter.

🤖

Agent Mode

AI autonomously edits your live test plan through 18 tools: add elements, set properties, run tests, and auto-correlate dynamic values, with confirmation-gated destructive ops. Claude & OpenAI.

🔗

8 LLM Providers

Chat with Claude, OpenAI, Gemini, DeepSeek, Ollama, Grok (xAI), Meta Muse, or AWS Bedrock, all inside JMeter. Model filtering hides non-chat models automatically.

🔍

Context-Aware @Commands

@this, @testplan, @optimize, @lint, @wrap, @code, and @usage. Each command understands your currently selected test-plan element.

💻

Multi-AI CLI Terminal

Run Claude Code, OpenAI Codex, OpenCode, Antigravity, or Grok CLI in an embedded terminal that receives your open .jmx as context.

⚡

Real-Time Streaming

Watch AI responses appear token-by-token, with a Stop button to cancel mid-response and an optional chime when the AI finishes.

🧹

Smart JSR223 Refactoring

Right-click in the JSR223 editor to refactor, format, or inject functions with AI: no copy-pasting between tools.

🔒

Local & Private via Ollama

Run fully offline with local models: zero data egress, with configurable thinking modes for reasoning models like DeepSeek R1.

🐾

Companion Pets

A draggable animated pet (quill, glim, peacock, or monkey) that cheers on clean runs and frowns on sampler failures.

🔥 Killer Feature

Agent Mode | AI with Tool Calling

Feather Wand doesn't just chat about your test plan, it acts on it. The agent reads your tree, calls tools to mutate elements, verifies each change, and iterates until the task is done. Every tool call streams to the chat in real time.

✓ Anthropic Claude ✓ OpenAI enable: jmeter.ai.agent.enabled=true

Tool calling works with Anthropic Claude and OpenAI models, the two providers with mature function-calling APIs. Other providers fall back to plain chat.

Read 4 tools

get_tree_state : Full test-plan tree with names, types, enabled state
get_element_config : All properties of a specific element
get_element_children : Children of a specific element
get_element_schema : Property schema and allowed values for an element type

Write 10 tools

add_element : Add a new element as a child of a parent
update_element_property : Set a scalar property on an element
set_property_list : Set a flat string-list property
set_structured_property_list : Set structured lists like headers and arguments
delete_element : Delete an element and its subtree (confirmation gated)
toggle_element : Enable or disable an element
move_element : Reparent an element (confirmation gated)
duplicate_element : Deep-clone an element's subtree
rename_element : Rename an element
reorder_element : Reposition an element among its siblings

Run 3 tools

run_test : Start the test plan
stop_test : Stop the running test
get_test_results : Run in a private engine and report pass/fail with failure details

Correlation 2 tools

find_correlation_candidates : Probe the plan and detect dynamic values needing correlation
apply_correlation : Add extractors and rewrite values to ${variable} (confirmation gated)

File 2 tools

save_plan : Save the test plan to a .jmx file
open_plan : Open a .jmx file (confirmation gated)

Safety Gates

Destructive operations (delete, move, open plan, apply correlation) ask for confirmation before executing.
Bounded iterations: the agent stops after 8 reason-act cycles by default, configurable via jmeter.ai.agent.max.iterations.
Graceful degradation: if the agent loop fails, you get a plain-text answer describing what it attempted.
Every mutation is undoable with Ctrl+Z when undo.history.size > 0 in user.properties.

See it work: natural language to tool calls

"Add an HTTP Request under the Thread Group and set its path to /login"

get_tree_state add_element update_element_property get_element_config

"Add a Response Assertion that checks for 200"

get_tree_state add_element set_property_list

"Find dynamic values that need correlation"

find_correlation_candidates

"Apply correlation for candidates 1 and 3"

apply_correlation

"Run the test and tell me if it passed"

run_test get_test_results

"Move the JSON Extractor under the first HTTP Request"

get_tree_state move_element

⚔️ Head to Head

Feather Wand vs AI Coding CLIs

Codex and Claude Code are general-purpose coding agents that edit files. Feather Wand is purpose-built to drive Apache JMeter from the inside, and it even ships both CLIs in an embedded terminal. Here is how they stack up.

Capability	Feather Wand	Codex	Claude Code
Runs inside JMeter	Yes, native plugin	No (available via Feather Wand's embedded terminal)	No (available via Feather Wand's embedded terminal)
JMeter-aware correlation	Yes, purpose-built tool call	General reasoning only	General reasoning only
Undo	Ctrl+Z, native JMeter undo stack	Git / manual backup	Git / manual backup
Autonomous test plan edits	Agent Mode, 18 tools (add, update, delete, move, run, correlate)	Yes, general file edits	Yes, general file edits
Model support	Claude, OpenAI, Gemini, DeepSeek, Ollama, Grok, Meta, Bedrock	GPT	Claude models
Subagents / parallel orchestration	Not built in	Yes	Yes
Setup	Install plugin, add your API key	Install CLI, authenticate	Install CLI, authenticate
Cost	Free and open source (MIT), bring your own API key	Subscription or API usage	Subscription or API usage
Best for	Fast, scoped JMeter edits and correlation without leaving the GUI	Deep reasoning, parallel subagent tasks across a repo	Deep reasoning across a whole codebase

Feather Wand is not a replacement for a general coding agent: it embeds Codex, Claude Code, and other CLIs so you can reach for them when the job outgrows the JMeter GUI.

Installation

Get Feather Wand up and running in minutes.

Plugins Manager (Recommended)

Open JMeter → Options → Plugins Manager → Available Plugins, search "Feather Wand", select it, then Apply Changes and Restart JMeter.

# JMeter → Options → Plugins Manager → Available Plugins
# Search "Feather Wand" → Apply Changes and Restart JMeter

Plugins Manager CLI

Headless and CI-friendly install via the Plugins Manager command line.

# Linux / macOS
bin/PluginsManagerCMD.sh install feather-wand-jmeter-ai-agent

# Windows
bin\PluginsManagerCMD.bat install feather-wand-jmeter-ai-agent

Manual JAR Install

Download the latest JAR from the GitHub Releases page, copy it into JMeter's lib/ext directory, and restart JMeter. Feather Wand appears in the Tools menu.

# Download from https://github.com/QAInsights/jmeter-ai/releases
cp <downloaded>.jar $JMETER_HOME/lib/ext/
$JMETER_HOME/bin/jmeter

Configure AI Provider

Copy jmeter-ai-sample.properties into your user.properties, add your API key (e.g. anthropic.api.key or openai.api.key), and restart JMeter. Then pick a model from the dropdown.

❓ FAQ

Frequently Asked Questions

What is Feather Wand for Apache JMeter?

Feather Wand is a free, MIT-licensed AI agent plugin for JMeter. Chat with 8 LLM providers to generate and analyze test plans, use context-aware @commands, run embedded AI CLI terminals (Claude Code, OpenAI Codex, and more), or enable Agent Mode to let the AI autonomously edit your test plan.

Which LLMs does Feather Wand support?

Eight providers: Anthropic Claude, OpenAI, Google Gemini, DeepSeek, Ollama (local), Grok (xAI), Meta Muse, and AWS Bedrock via the Converse API. Non-chat models are filtered out of the dropdown automatically.

What is Agent Mode in Feather Wand?

Agent Mode lets the AI autonomously edit your live test plan through 18 tools: reading the tree, adding and configuring elements, running tests, and detecting plus applying correlations. Destructive operations ask for confirmation, iterations are bounded, and everything is undoable with Ctrl+Z. It works with Claude and OpenAI models and is enabled with jmeter.ai.agent.enabled=true.

How do I install Feather Wand?

The easiest way is the JMeter Plugins Manager: Options → Plugins Manager → Available Plugins → search "Feather Wand" → Apply Changes and Restart JMeter. For CI, use the Plugins Manager CLI: PluginsManagerCMD install feather-wand-jmeter-ai-agent. Then copy jmeter-ai-sample.properties into your user.properties and add your API key.

Is Feather Wand free?

Yes, completely. Feather Wand is open source under the MIT license, including Agent Mode, all 8 LLM providers, the CLI terminal, and every @command. You only pay for your own LLM API usage (or nothing at all with local Ollama models).

Does my test data leave my machine?

Not if you don't want it to. Feather Wand supports fully local deployments via Ollama, so test plans and results can stay on your machine with zero data egress.

GitHub Repository

Explore the source, report issues, and contribute.

QAInsights/jmeter-ai

The AI Agent for Apache JMeter

Java Stars Forks MIT License

Report an Issue

Found a bug? Let us know.

Discussions

Join the community conversation.

Pull Requests

Contribute to development.

Releases

Download the latest version.

Connect

Follow QAInsights for updates, tutorials, and community events.

GitHub

https://github.com/QAInsights

X

https://x.com/QAInsights

YouTube

https://youtube.com/@QAInsights

https://linkedin.com/in/naveenkumarn

Website

https://qainsights.com