claudegoodies
Command

list

From ruvnet

List all active agents

Install

/list

Facts

Repository
ruvnet/ruflo
Status
Actively maintained
Last commit
Source file
v3/@claude-flow/cli/.claude/commands/agents/list.md

Source preview

The instructions Claude Code reads when this command runs.

# Agent List Command

List all active agents in the Claude Flow system with filtering options.

## Usage

```bash
npx claude-flow agent list [options]
npx claude-flow agent ls [options]  # Alias
```

## Options

| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| `--all` | `-a` | Include inactive/terminated agents | false |
| `--type` | `-t` | Filter by agent type | All |
| `--status` | `-s` | Filter by status (active, idle, terminated) | active |
| `--format` | | Output format (table, json) | table |

## Examples

```bash
# List all active agents
npx claude-flow agent list

# List all agents including inactive
npx claude-flow agent list --all

# Filter by type
npx claude-flow agent list -t coder

# Filter by status
npx claude-flow agent list -s idle

# JSON output for scripting
npx claude-flow agent list --format json

# Combined filters
npx claude-flow agent list -t researcher -s active
```

## Output

```
Active Agents

+--------------------+-----------+--------+----------+---------------+
| ID                 | Type      | Status | Created  | Last Activity |
+--------------------+-----------+--------+----------+---------------+
| coder-lx7m9k2      | coder     | active | 10:30:15 | 10:45:23      |
| researcher-abc123  | researcher| idle   | 09:15:00 | 10:20:45      |
| tester-def456      | tester    | active | 11:00:00 | 11:12:30      |
+
View full source on GitHub →

Other slash commands