Skip to main content
subagent CX Codex

Load Balancing Coordinator — Claude Code subagent: setup and use

The Load Balancing Coordinator subagent assigns work according to agent load and task priority. Use it to manage queues or move work away from overloaded agents.

no license ★ 850 updated 2026-10-26

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

What Load Balancing Coordinator does

Load Balancing Coordinator checks active agents, identifies overloaded and underused ones, and can move tasks between them. Its scheduling approaches include taking work from another agent’s queue, weighted scheduling, and priority-based queues. Critical tasks are handled ahead of lower-priority work.

The profile also describes MCP-based monitoring for performance reports, bottleneck analysis, and token use. It can inspect agent lists and metrics, then send task migrations through MCP. The listed tools are performance_report, bottleneck_analyze, token_usage, agent_list, agent_metrics, and load_balance; the monitoring and migration flow depends on those tools being available.

What it helps with

  • Move tasks from overloaded agents to less busy ones
  • Distribute work using current agent load
  • Schedule queued tasks by priority and deadline
  • Collect performance metrics and spot bottlenecks

Example prompts for the agent

  • Balance the tasks across agents using their current load.
  • Review agent metrics and propose task migrations.
  • Set up the queue so critical tasks run first.

How to install Load Balancing Coordinator

Manually: put the files in place

.claude/agents/load-balancer.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 Load Balancing Coordinator

How do I install Load Balancing Coordinator in Claude Code?

Add .claude/agents/load-balancer.md to the project. That is the provided installation path for Claude Code.

What does Load Balancing Coordinator do?

It distributes tasks based on agent load, schedules work by priority, and can migrate tasks between agents.

Which MCP tools does it use for load balancing?

The described flow uses performance_report, bottleneck_analyze, token_usage, agent_list, agent_metrics, and load_balance.

Similar subagents

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

From the same set76

The whole set →
repo-architect repo-architect maps how your repositories are laid out and proposes a cleaner shape: a shared project template plus file sync across repos through GitHub MCP. CX Codex ★ 850repo stars code-review-swarm code-review-swarm deploys coordinated AI review agents against pull requests via the GitHub CLI. It flags security flaws and architecture drift before merging. CX Codex ★ 850repo stars supabase-admin supabase-admin — a Claude command that puts the agent in charge of Supabase: Postgres schemas, RLS policies, auth and storage buckets, all through the MCP server rather than the CLI. CX Codex +1 ★ 850repo stars ml-developer ml-developer — a dedicated subagent for training machine learning models, exploring hyperparameter spaces, and editing Jupyter notebooks. CX Codex ★ 850repo stars release-swarm release-swarm is a Claude Code command for planning releases from commits and merged pull requests, preparing changelogs, and coordinating publication through GitHub CLI. CX Codex +1 ★ 850repo stars v3-performance-engineer v3-performance-engineer — a subagent that benchmarks claude-flow v3 and pushes it toward stated goals: Flash Attention, HNSW search, cold start, memory. Use it when the numbers are claimed and need proving. CX Codex ★ 850repo stars multi-repo-swarm multi-repo-swarm — a subagent for Claude Code that orchestrates multiple agents across your organization's repositories. Runs synchronized tasks, manages dependencies, and links pull requests between projects. CX Codex ★ 850repo stars consensus-coordinator consensus-coordinator — a Claude subagent that computes distributed consensus: Byzantine fault tolerance, voting and agreement across an agent swarm. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open