🪄 Why "Feather Wand"? My kids named it after a Bluey episode, where a simple feather becomes a magical wand that turns the ordinary into something special. That's exactly what this plugin does for your JMeter workflow.

• Features
• Installation
• Configuration
• Special Commands
• Streaming
• Response Chime
• AI CLI Terminal
• API Setup
• Roadmap & Issues
• Disclaimer

1. Install JMeter Plugins Manager → https://jmeter-plugins.org/
2. Restart JMeter
3. Open Plugins Manager → Available Plugins
4. Search for "feather wand"
5. Select it → Apply Changes and Restart JMeter

1. Download the latest JAR from Releases
2. Drop it into JMeter's lib/ext directory
3. Copy jmeter-ai-sample.properties into jmeter.properties (or user.properties)
4. Add your API key(s) and restart JMeter

See Releases for the latest JAR.

Copy jmeter-ai-sample.properties into your jmeter.properties or user.properties and adjust the values below.

Prerequisite CLIs

Each service supports its own *.system.prompt property — tweak them in your properties file to focus the AI on specific JMeter topics or team conventions.

Type any of these directly in the chat box. All commands are context-aware and work with the currently selected test-plan element.

• Run it after importing a recorded test plan to clean up generic names.
• Use it before sharing plans with your team.
• Apply custom rules: @lint rename based on the URL.

@wrap uses pattern matching (not AI) to group related HTTP samplers under Transaction Controllers, preserving child elements and hierarchy. Great for imported or recorded plans.

All five AI services support real-time streaming out of the box. Responses appear token-by-token as they are generated.

Disable streaming:

jmeter.ai.streaming.enabled=false

Get an audible cue when the AI finishes responding so you can multitask across windows.

jmeter.ai.response.chime=true

The bundled WAV plays from src/main/resources/org/qainsights/jmeter/ai/sound/jmeter-chime.wav with an MP3 fallback.

An embedded interactive terminal (JediTerm) that brings agentic AI CLIs directly into JMeter.

Supported CLIs: Claude Code · OpenAI Codex · OpenCode · Antigravity

How it works

1. Install one or more CLIs on your PATH.
2. Feather Wand auto-detects them on startup.
3. Pick a CLI from the dropdown in the terminal header.
4. The terminal receives your open .jmx context via an auto-generated CLAUDE.md.
5. Use natural language to run tests, parse JTL files, refactor scripts, and more.

Buttons

• Reload — refresh the test plan from disk.
• Ctx — resend the current test-plan context.

Architecture Built on an Adapter Pattern: AiCliAdapter → BaseCliAdapter → concrete adapters (ClaudeCodeCliAdapter, OpenAiCodexCliAdapter, ...). To add a new CLI, implement AiCliAdapter and register it in detectAvailableClis().

⚠️ Caution: AI CLIs can execute commands and modify files. Review each CLI's documentation before enabling.

Set jmeter.ai.service.type=ollama to switch to a local model. All other providers work side-by-side; just pick the model from the UI dropdown.

Feather Wand automatically hides non-chat models so you only see useful options:

• OpenAI — hides audio, TTS, whisper, davinci, search, realtime, and instruct models.
• Claude — shows only the latest available models.
• Gemini — shows only gemini-* and gemma-* chat models.

Default models: claude-sonnet-4-6 · gpt-4o · gemini-2.5-flash · deepseek-chat · deepseek-r1:1.5b

Found a bug or have an idea? Open an issue.

See what's next on the project board.

• Verify everything — AI can hallucinate. Double-check critical suggestions before production runs.
• Backup first — Save your .jmx before letting AI refactor it.
• Test in staging — Validate changes in a safe environment.
• Watch costs — Token usage adds up. Use @usage to keep an eye on it.
• No secrets in chat — Never paste credentials or proprietary code into the chat box.

Feather Wand is an assistant, not a replacement for engineering judgment.