team-status — Claude Code command: agent team status at a glance

---
description: "Display team members, task status, and progress for an active agent team"
argument-hint: "[team-name] [--tasks] [--members] [--json]"
---

# Team Status

Display the current state of an active agent team including members, tasks, and progress.

## Phase 1: Team Discovery

1. Parse `$ARGUMENTS` for team name and flags:
   - If team name provided, use it directly
   - If no team name, check `~/.claude/teams/` for active teams
   - If multiple teams exist and no name specified, list all teams and ask user to choose
   - `--tasks`: show only task details
   - `--members`: show only member details
   - `--json`: output raw JSON instead of formatted table

2. Read team config from `~/.claude/teams/{team-name}/config.json` using the Read tool
3. Call `TaskList` to get current task state

## Phase 2: Status Display

### Members Table

Display each team member with their current state:

```
Team: {team-name}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Members:
  Name              Role              Status
  ─────────────────────────────────────────
  security-rev      team-reviewer     working on task #2
  perf-rev          team-reviewer     idle
  arch-rev          team-reviewer     working on task #4
```

### Tasks Table

Display tasks with status, assignee, and dependencies:

```
Tasks:
  ID   Status        Owner           Subject
  ─────────────────────────────────────────────────
  #1   completed     security-rev    Review auth module
  #2   in_progress   security-rev    Review API endpoints
  #3   completed     perf-rev        Profile database queries
  #4   in_progress   arch-rev        Analyze module structure
  #5   pending       (unassigned)    Consolidate findings

Progress: 40% (2/5 completed)
```

### JSON Output

If `--json` flag is set, output the raw team config and task list as JSON.