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

name	description	type
status	Show detailed status of an agent	command

Agent Status Command

Display comprehensive status information for a specific agent including metrics, configuration, and activity.

Usage

npx claude-flow agent status <agent-id>
npx claude-flow agent status --id <agent-id>

Options

Option	Description	Default
--id	Agent ID (alternative to positional arg)	Required
--format	Output format (table, json)	table

Examples

# Get status by ID
npx claude-flow agent status coder-lx7m9k2

# Using --id flag
npx claude-flow agent status --id researcher-abc123

# JSON output
npx claude-flow agent status coder-lx7m9k2 --format json

Output

+--------------------------------------------------+
|              Agent: coder-lx7m9k2                |
+--------------------------------------------------+
| Type: coder                                      |
| Status: active                                   |
| Created: 1/8/2026, 10:30:15 AM                   |
| Last Activity: 1/8/2026, 10:45:23 AM             |
+--------------------------------------------------+

Metrics
+-------------------------+----------+
| Metric                  |    Value |
+-------------------------+----------+
| Tasks Completed         |       12 |
| Tasks In Progress       |        1 |
| Tasks Failed            |        0 |
| Avg Execution Time      |  245.5ms |
| Uptime                  |   15.3m  |
+-------------------------+----------+

Detailed Information

The status command provides:

Basic Info

• Agent ID and type
• Current status (active/idle/terminated)
• Creation timestamp
• Last activity timestamp

Performance Metrics

• Tasks completed successfully
• Tasks currently in progress
• Failed task count
• Average execution time
• Total uptime

Configuration (when applicable)

• Provider and model
• Timeout settings
• Auto-tools enabled
• Custom capabilities

JSON Output

{
  "id": "coder-lx7m9k2",
  "agentType": "coder",
  "status": "active",
  "createdAt": "2026-01-08T10:30:15.000Z",
  "lastActivityAt": "2026-01-08T10:45:23.000Z",
  "config": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "timeout": 300,
    "autoTools": true
  },
  "metrics": {
    "tasksCompleted": 12,
    "tasksInProgress": 1,
    "tasksFailed": 0,
    "averageExecutionTime": 245.5,
    "uptime": 918000
  }
}

Related Commands

• npx claude-flow agent list - Find agent IDs
• npx claude-flow agent metrics - Aggregate metrics
• npx claude-flow agent health - Health check
• npx claude-flow agent logs <id> - Activity logs