# performance-benchmarker

performance-benchmarker is a Claude Code subagent that measures throughput, latency, and resource use to compare Byzantine, Raft, and Gossip consensus protocols.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/consensus/performance-benchmarker.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/performance-benchmarker

## What it does

The subagent provides a complete benchmarking toolkit: generates protocol load, tracks transaction throughput and latency, monitors CPU, memory, and network usage. It stores results in a time-series database for historical tracking and produces comparative analysis across protocols. An adaptive optimizer adjusts load parameters in real time based on test success rates.

Useful when building and tuning distributed systems: the subagent automatically executes full benchmark cycles on hook triggers, measures latency percentiles (p95, p99), and analyzes fault tolerance. Results are timestamped so you can detect performance degradation or improvements after code changes.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/performance-benchmarker.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/performance-benchmarker.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/performance-benchmarker.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/consensus/performance-benchmarker.md

## When to use it
- measure throughput of consensus algorithms under varying load
- compare latency across Byzantine, Raft, and Gossip protocols
- track resource usage (CPU, memory, network) during distributed consensus
- identify bottlenecks and optimize protocol parameters automatically
- maintain a searchable history of benchmark runs

## Example prompts
- Run performance-benchmarker to compare Byzantine and Raft at 1000 transactions per second
- Collect latency and throughput metrics for Gossip protocol while varying node count
- Analyze Raft fault tolerance when one validator fails and compare against Byzantine

## Similar
- [benchmark-model](https://affpapa.org/en/nevibecode/skills/benchmark-model.md) — skill · 1000 installs
- [thinking-theory-of-constraints](https://affpapa.org/en/nevibecode/skills/thinking-theory-of-constraints.md) — skill · 767 installs
- [perf-benchmarker](https://affpapa.org/en/nevibecode/skills/perf-benchmarker.md) — skill · 2300 installs
- [api-benchmarker](https://affpapa.org/en/nevibecode/plugins/api-benchmarker.md) — plugin · ★ 2858 repo stars
- [http-load-profiler](https://affpapa.org/en/nevibecode/skills/http-load-profiler.md) — skill · ★ 4719 repo stars
- [investigating-performance](https://affpapa.org/en/nevibecode/skills/investigating-performance.md) — skill · 146 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
