# performance-auditor

The performance-auditor subagent inspects code for algorithmic, data-access, and resource bottlenecks. Use it after changes on hot paths or when you need to reason about how code scales.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/performance-auditor.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/samarth-gupta-performance-auditor

## What it does

\`performance-auditor` examines code without running it. It reasons about how costs change as inputs grow, looking for repeated data access, unnecessary passes over collections, and resource growth. Ask a focused question for advice, or request an audit of changed files or a defined scope.

It can use `Read`, `Grep`, `Glob`, and `Bash`, and keeps project notes about hot paths and performance-sensitive areas. It does not run builds, tests, or benchmarks, so its findings are based on code rather than measured timings. When static inspection cannot settle the impact, profiling is needed.

Its remit is performance. Code quality, security, and architectural structure belong to other named agents, which it may point out without investigating those areas. That boundary matters: this agent’s review is not a substitute for a security audit.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-coding@Claudest
```

2. **Manually: put the files in place**
- File: `.claude/agents/performance-auditor.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-auditor.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-auditor.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/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/agents/performance-auditor.md

## When to use it
- spot nested iteration whose cost grows with input size
- find external queries or file reads repeated for each collection item
- check for full dataset reads without bounds
- identify accumulating collections and repeated allocations on hot paths

## Example prompts
- Review this changed loop and explain how its cost grows with larger inputs.
- Audit these files for performance bottlenecks, especially queries inside loops.
- Check hot-path code for repeated reads and memory that keeps growing.

## Similar
- [security-auditor](https://affpapa.org/en/nevibecode/agents/security-auditor.md) — subagent · 10718 installs
- [firebase-security-rules-auditor](https://affpapa.org/en/nevibecode/skills/firebase-security-rules-auditor.md) — skill · 150300 installs
- [mcp-security-auditor](https://affpapa.org/en/nevibecode/agents/mcp-security-auditor.md) — subagent · 851 installs
- [smart-contract-auditor](https://affpapa.org/en/nevibecode/agents/smart-contract-auditor.md) — subagent · 701 installs
- [compliance-auditor](https://affpapa.org/en/nevibecode/agents/compliance-auditor.md) — subagent · 421 installs
- [supply-chain-risk-auditor](https://affpapa.org/en/nevibecode/skills/supply-chain-risk-auditor.md) — skill · 9500 installs

## Other versions with the same name
- [performance-auditor · qdhenry](https://affpapa.org/en/nevibecode/agents/performance-auditor.md) — ★ 1357 repo stars

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 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
