Multi-agent coordination status check. Shows agent workload, active tasks, and team health with formatted progress bars and statistics.
Displays formatted multi-agent team status with workload visualization and health monitoring.
/plugin marketplace add gsornsen/mycelium/plugin install mycelium-core@myceliumagent-typeCheck current workload and coordination status of Claude Code subagents with formatted visualization.
Command arguments: $ARGS
Coordination Method: Redis MCP with JSON serialization and datetime handling
Display formatted team status using Redis coordination data with proper JSON parsing:
Parse command arguments to determine display mode:
Query Redis with JSON parsing:
agents:status hashagents:heartbeat hash_at or containing timestamp)Display formatted output matching these patterns:
=== Multi-Agent Team Status ===
Coordination Method: Redis MCP
Agent Workload:
project-manager ██████████ 100% | 1 active task
platform-engineer ██████████ 100% | 1 active task
ai-engineer ████████░░ 80% | 2 active tasks
data-engineer ████░░░░░░ 40% | 1 active task
python-pro ░░░░░░░░░░ 0% | available
Task Distribution:
Total Active: 5 tasks
Average Load: 64%
Load Variance: 35% (⚠️ unbalanced)
Heartbeat Status:
✅ All agents reporting healthy
Last Updated: 2025-11-07 20:45:30
Progress Bar Format:
█ for used capacity, ░ for availableMath.round(workload / 10)Workload Indicators:
Balance Status:
Heartbeat Freshness:
When user specifies agent type (e.g., /team-status project-manager):
=== Agent Status: project-manager ===
Current Status: BUSY (100% capacity)
Active Tasks (1):
1. smart-onboarding-coordination
- Progress: 45%
- Duration: 2h 15m
- Description: Coordinating Smart Onboarding implementation
Recent History (from status data):
- Current workload: 100%
- Task count: 1
- Last updated: 5m ago
Circuit Breaker: ✅ CLOSED (healthy)
Last Heartbeat: 5m ago
Task Display:
started_at if presentHeartbeat Age Calculation:
Implement this parsing pattern (from RedisCoordinationHelper):
def parse_redis_value(raw_value: str) -> dict:
"""Parse Redis value with JSON deserialization and datetime restoration."""
try:
parsed = json.loads(raw_value)
# Handle non-dict values (wrap in dict)
if not isinstance(parsed, dict):
return {"value": parsed}
# Restore datetime fields
for key, value in parsed.items():
if isinstance(value, str) and (key.endswith("_at") or "timestamp" in key.lower()):
try:
# Convert ISO format string to datetime
parsed[key] = datetime.fromisoformat(value)
except ValueError:
# Not a valid datetime, keep as string
pass
return parsed
except json.JSONDecodeError:
# Not JSON, return as plain value
return {"value": raw_value}
Load Variance (standard deviation):
def calculate_variance(workload_values: list[int]) -> float:
"""Calculate standard deviation of workload values."""
if not workload_values:
return 0.0
mean = sum(workload_values) / len(workload_values)
squared_diffs = [(val - mean) ** 2 for val in workload_values]
variance = sum(squared_diffs) / len(workload_values)
return variance ** 0.5 # Standard deviation
Duration Formatting:
def format_duration(start_time: datetime) -> str:
"""Format duration from start time to now."""
delta = datetime.now() - start_time
total_seconds = int(delta.total_seconds())
hours = total_seconds // 3600
minutes = (total_seconds % 3600) // 60
if hours > 0:
return f"{hours}h {minutes}m"
else:
return f"{minutes}m"
No Redis Connection:
⚠️ No coordination infrastructure detected
To enable real-time agent coordination:
Option 1 (Recommended): Deploy Redis Stack
mycelium deploy start --yes
Option 2: Create coordination directory
mkdir -p .claude/coordination/
# Agents will create status files here
Empty Redis Data:
⚠️ No agents currently coordinating
To enable real-time agent coordination:
Option 1: Deploy Redis Stack (recommended)
mycelium deploy start --yes
Option 2: Create coordination directory
mkdir -p .claude/coordination/
Agent Not Found (in detailed mode):
❌ Agent 'unknown-agent' not found
Available agents:
- project-manager
- platform-engineer
- ai-engineer
- data-engineer
- python-pro
Stale Heartbeats (age > 60 minutes):
Heartbeat Status:
⚠️ Stale heartbeats detected:
- ai-engineer: last seen 2h 15m ago
- ml-engineer: last seen 3h 42m ago
- python-pro: last seen 1h 5m ago
Use these MCP tools to query Redis:
// Get all agent statuses
const agentStatuses = await mcp__RedisMCPServer__hgetall({
name: "agents:status"
});
// Get specific agent status
const status = await mcp__RedisMCPServer__hget({
name: "agents:status",
key: "ai-engineer"
});
// Get all heartbeats
const heartbeats = await mcp__RedisMCPServer__hgetall({
name: "agents:heartbeat"
});
// Get specific heartbeat
const heartbeat = await mcp__RedisMCPServer__hget({
name: "agents:heartbeat",
key: "ai-engineer"
});
_at or containing timestamp)This command integrates with:
RedisCoordinationHelper library for JSON serialization patternsmycelium deploy command for Redis Stack deploymentQuery Redis MCP Server:
agents:status hash for all agent dataagents:heartbeat hash for heartbeat timestampsHandle Parsing Errors:
{"value": raw_value}Calculate Statistics:
Check Heartbeat Health:
Scenario 1: Active Team
=== Multi-Agent Team Status ===
Coordination Method: Redis MCP
Agent Workload:
ai-engineer ██████████ 100% | 3 active tasks (at capacity)
data-engineer ████████░░ 80% | 2 active tasks
python-pro ████░░░░░░ 40% | 1 active task
performance-eng ░░░░░░░░░░ 0% | available
Task Distribution:
Total Active: 6 tasks
Average Load: 55%
Load Variance: 38% (⚠️ unbalanced)
Heartbeat Status:
✅ All agents reporting healthy
Last Updated: 2025-11-07 20:45:30
Scenario 2: Stale Heartbeats
=== Multi-Agent Team Status ===
Coordination Method: Redis MCP
Agent Workload:
project-manager ██████████ 100% | 1 active task
Task Distribution:
Total Active: 1 task
Average Load: 100%
Load Variance: 0% (✅ balanced)
Heartbeat Status:
⚠️ Stale heartbeats detected:
- project-manager: last seen 25 days ago
Last Updated: 2025-11-07 20:45:30
Scenario 3: Detailed Agent View
=== Agent Status: ai-engineer ===
Current Status: BUSY (85% capacity)
Active Tasks (2):
1. train-voice-model
- Progress: 35%
- Duration: 4h 23m
- Description: Training custom voice model
2. evaluate-checkpoint
- Progress: 70%
- Duration: 45m
- Description: Evaluating model checkpoint
Recent History (from status data):
- Current workload: 85%
- Task count: 2
- Last updated: 2m ago
Circuit Breaker: ✅ CLOSED (healthy)
Last Heartbeat: 2m ago
Scenario 4: No Agents
=== Multi-Agent Team Status ===
Coordination Method: Redis MCP
⚠️ No agents currently coordinating
To enable real-time agent coordination:
Option 1: Deploy Redis Stack (recommended)
mycelium deploy start --yes
Option 2: Create coordination directory
mkdir -p .claude/coordination/
When user runs /team-status:
$ARGS if providedmcp__RedisMCPServer__hgetall for agents:statusmcp__RedisMCPServer__hgetall for agents:heartbeatparse_redis_value() logic for each valueNow implement this formatted team status display with proper JSON parsing and error handling.