tasq/node_modules/@claude-flow/cli/.claude/commands/agents/pool.md

name	description	type
pool	Manage agent pool for scaling	command

Agent Pool Command

Manage the agent pool for automatic scaling and resource optimization.

Usage

npx claude-flow agent pool [options]

Options

Option	Short	Description	Default
--size	-s	Set pool size	Current
--min		Minimum pool size	1
--max		Maximum pool size	10
--auto-scale		Enable auto-scaling	true
--warmup		Pre-warm agents	false

Examples

# View current pool status
npx claude-flow agent pool

# Set pool size
npx claude-flow agent pool --size 5

# Configure auto-scaling
npx claude-flow agent pool --min 2 --max 15 --auto-scale

# Pre-warm agents for fast response
npx claude-flow agent pool --warmup

# Disable auto-scaling
npx claude-flow agent pool --auto-scale false

Output

Agent Pool Configuration

+----------------+----------+
| Setting        | Value    |
+----------------+----------+
| Current Size   | 3        |
| Min Size       | 1        |
| Max Size       | 10       |
| Auto-Scale     | enabled  |
| Warmup         | disabled |
+----------------+----------+

Pool Status
+------------+--------+------+-------+
| Type       | Active | Idle | Total |
+------------+--------+------+-------+
| coder      | 1      | 1    | 2     |
| researcher | 1      | 0    | 1     |
+------------+--------+------+-------+

Auto-Scale Rules
  - Scale up when: Queue > 5 tasks
  - Scale down when: Idle > 5 minutes
  - Cooldown: 60 seconds

Auto-Scaling Behavior

Scale Up Triggers

• Task queue exceeds threshold
• Response time increases
• Error rate increases

Scale Down Triggers

• Agents idle for extended period
• Task queue empty
• Resource pressure

Pre-Warming

Pre-warm agents to reduce cold-start latency:

npx claude-flow agent pool --warmup

# Pre-warms default agent types:
# - coder (2 instances)
# - researcher (1 instance)
# - tester (1 instance)

Pool Configuration File

Configure in .claude-flow/config.yaml:

agent:
  pool:
    minSize: 2
    maxSize: 15
    autoScale: true
    warmup:
      enabled: true
      types:
        - type: coder
          count: 2
        - type: researcher
          count: 1
    scaleRules:
      scaleUpThreshold: 5
      scaleDownIdleTime: 300
      cooldownPeriod: 60

Related Commands

• npx claude-flow agent spawn - Manual agent spawning
• npx claude-flow agent list - View active agents
• npx claude-flow swarm scale - Swarm-level scaling