Skip to content
PopKit Documentation

Power Mode

Power Mode

Section titled “Power Mode”

Power Mode enables parallel agent collaboration for complex tasks requiring multiple specialized agents working together.

What is Power Mode?

Section titled “What is Power Mode?”

Power Mode orchestrates multiple agents simultaneously to tackle complex workflows that would be too slow or cumbersome with a single agent.

Use Cases:

  • Large-scale refactoring across many files
  • Comprehensive security audits
  • Multi-component feature development
  • Architecture analysis and migration

Modes of Operation

Section titled “Modes of Operation”
Section titled “Native Async Mode (Recommended)”

Requirements: Claude Code 2.1.33+ (tested through 2.1.79)

Features:

  • Zero setup required
  • 5+ agents via Background Task tool
  • Event-driven agent lifecycle management
  • Graceful shutdown with configurable timeout
  • Action tracking for dashboard state
  • Best for most use cases

Activation:

Terminal window
/popkit-core:power start

Redis Mode (Advanced)

Section titled “Redis Mode (Advanced)”

Requirements: Redis server, Claude Code 2.1.33+ (tested through 2.1.79)

Features:

  • 10+ agents with persistent coordination
  • Best for very complex workflows
  • Requires Redis setup

Setup:

Terminal window
# Install Redis
# Configure connection in .popkit/config.json


/popkit-core:power start --redis

File-Based Mode (Legacy)

Section titled “File-Based Mode (Legacy)”

Requirements: None

Features:

  • 2 agents sequential
  • Fallback for older Claude Code versions
  • No external dependencies

Activation: Automatic fallback

Using Power Mode

Section titled “Using Power Mode”

1. Check Status

Section titled “1. Check Status”
Terminal window
/popkit-core:power status

This shows:

  • Current mode (Native/Redis/File)
  • Active agents
  • Performance metrics

2. Start Power Mode

Section titled “2. Start Power Mode”
Terminal window
/popkit-core:power start

3. Run Workflows

Section titled “3. Run Workflows”
Terminal window
# Feature development with multiple agents
/popkit-dev:dev "Implement OAuth2" --power


# Comprehensive security audit
/popkit-ops:security scan --power


# Architecture analysis
/popkit-core:project analyze --power

4. Monitor Progress

Section titled “4. Monitor Progress”
Terminal window
/popkit-core:power metrics

Shows:

  • Agents active
  • Tasks in progress
  • Completion status

5. Stop Power Mode

Section titled “5. Stop Power Mode”
Terminal window
/popkit-core:power stop

Performance Comparison

Section titled “Performance Comparison”
ModeAgentsSetupUse Case
Native Async5+NoneMost workflows (recommended)
Redis10+RedisVery complex workflows
File-Based2NoneSimple workflows, legacy

Best Practices

Section titled “Best Practices”
  1. Start with Native Async: Works for 95% of use cases
  2. Use Redis for Scale: Only when you need 10+ agents
  3. Monitor Performance: Check metrics to optimize
  4. Stop When Done: Free resources after completion

Troubleshooting

Section titled “Troubleshooting”

Power Mode Won’t Start

Section titled “Power Mode Won’t Start”

Symptom: power start fails

Solutions:

  • Check Claude Code version (need 2.1.33+, tested through 2.1.79)
  • Verify Redis is running (for Redis mode)
  • Check logs: /popkit-core:power status --verbose

Agents Not Responding

Section titled “Agents Not Responding”

Symptom: Tasks stuck in progress

Solutions:

  • Check individual agent logs
  • Restart Power Mode
  • Reduce agent count

Performance Issues

Section titled “Performance Issues”

Symptom: Slow responses

Solutions:

  • Switch to Native Async mode
  • Reduce concurrent agents
  • Check system resources

Next Steps

Section titled “Next Steps”