Skip to main content
subagent CX Codex

Performance Monitor — Claude Code subagent: what it does

Performance Monitor collects system and agent metrics, hunts bottlenecks and watches SLA thresholds. Useful when several agents run at once and it is unclear which one is slow.

no license ★ 850 updated 2026-10-26

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/performance-monitor.md
Open on GitHub

What Performance Monitor does

Metrics come from several places at once: CPU load, memory pressure, disk and network I/O, process and thread counts. The agent also calls agent_list and agent_metrics over MCP and scores each agent on efficiency, responsiveness and reliability. Those calls need a running MCP server with both tools, otherwise that half of the report stays empty.

Bottleneck hunting is split across six detectors: CPU, memory, I/O, network, coordination, task queue. They run in parallel and the findings get ranked by severity. A ring buffer holding 1000 entries keeps signatures of past incidents, so a problem that keeps returning is recognised instead of rediscovered.

SLA work goes through defineSLA. Defaults are 99.9% availability, 1000 ms response time, 100 requests per second, 0.1% error rate and 300 s recovery, checked every 60 s over a 300 s window. Alert thresholds sit at 0.8, 0.9 and 1.0 of the target.

What it helps with

  • spot which agent is eating the most CPU
  • separate a one-off spike from a recurring bottleneck
  • set SLA limits and catch breaches as they happen
  • read system and agent numbers in a single report
  • see whether tasks stall on memory, disk or coordination

Example prompts for the agent

  • Collect the current system and agent metrics and show which agent uses the most CPU.
  • Analyze the bottlenecks and rank them by severity.
  • Define an SLA for the api service with 99.9% availability and 1000 ms response time, then check for violations.

How to install Performance Monitor

Manually: put the files in place

.claude/agents/performance-monitor.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about Performance Monitor

How do I install Performance Monitor in Claude Code?

Put the file at .claude/agents/performance-monitor.md inside your project. The subagent then shows up in the agent list.

What does Performance Monitor do?

It gathers system and agent metrics, detects bottlenecks across several layers, tracks SLA compliance and flags anomalies.

Which SLA thresholds does it use by default?

99.9% availability, 1000 ms response time, 100 requests per second, 0.1% error rate and 300 s recovery, evaluated every 60 s over a 300 s window.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set76

The whole set →
parallel-execution-guide The parallel-execution-guide prompt guides Claude Code through splitting work into independent tasks, spawning CLI subagents, and combining their results. Use it for parallel research or code review. GP ChatGPT ★ 850repo stars architecture A subagent for the Architecture stage of SPARC. It turns pseudocode into a component design, pulls similar patterns from claude-flow memory, and stores what worked. CX Codex ★ 850repo stars Resource Allocator Resource Allocator manages agent swarm capacity through adaptive resource distribution and predictive scaling across CPU, memory, storage, and network channels. CX Codex ★ 850repo stars release-manager release-manager runs a multi-package release: version bumps, tests, deploy and rollback, then keeps what worked in memory for the next one. CX Codex ★ 850repo stars Benchmark Suite Benchmark Suite runs throughput and latency benchmarks, measures resource consumption, and detects performance regressions in agent clusters. CX Codex ★ 850repo stars security-manager security-manager — a Claude Code subagent that embeds cryptographic security into distributed consensus protocols. Runs on critical operations, verifying threshold signatures, detecting attacks, and encrypting node communications. CX Codex ★ 850repo stars hierarchical-coordinator hierarchical-coordinator — a coordinator subagent that splits a job into sub-tasks and hands them to worker agents through the claude-flow MCP server. Fits work that runs top-down. CX Codex ★ 850repo stars refinement SPARC methodology subagent for iterative code refinement. Optimizes architecture, runs test suites, and learns from refactoring history. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open