claude-load-test-agent

k6 load test execution and automated report generation agent for Claude Code.

Install the agent, point it at your k6 scripts, and it will run tests, parse metrics, and generate structured markdown reports automatically.

Installation

npm install claude-load-test-agent

After installation, the agent is available in Claude Code. Just ask:

"Run API load test"
"Execute k6 performance test"

Trigger Keywords: load test, performance test, k6, stress test

Prerequisites

• k6 installed (brew install k6 on macOS)
• Claude Code

What It Does

1. Discovers k6 test scripts in your project
2. Executes the tests via k6 run
3. Parses metrics from k6 output (TPS, p95, avg response time, error rate)
4. Generates a structured markdown report

Demo Results

Real results from running the agent against test-api.k6.io:

Health Check Test

Script: examples/scripts/health-check.js — 10 VUs, 40s duration

| Metric | Value | |--------|-------| | TPS | 12.66 req/s | | p95 Response Time | 197.44ms | | Avg Response Time | 101.42ms | | Error Rate | 0.00% | | Total Requests | 508 |

Multi-Endpoint Test

Script: examples/scripts/api-endpoints.js — 20 VUs, 50s duration, 3 endpoints

| Metric | Value | |--------|-------| | TPS | 36.93 req/s | | p95 Response Time | 195.1ms | | Avg Response Time | 99.7ms | | Error Rate | 0.00% | | Total Requests | 1,872 |

Full generated reports: examples/results/

Report Format

The agent generates reports following this structure:

# {Feature} Load Test Results

## Test Environment
| Item | Value |
|------|-------|
| Date | 2026-02-06 |
| Target URL | https://api.example.com |
| VUsers | 20 |
| Duration | 50s |

## Results
| Metric | Value |
|--------|-------|
| TPS | 36.93 req/s |
| p95 Response Time | 195.1ms |
| Avg Response Time | 99.7ms |
| Error Rate | 0.00% |

## Analysis
{Auto-generated analysis of the results}

The agent also supports Before/After comparison reports for performance optimization tracking.

License

Apache 2.0