Back to Agents

Team Status

plugins/agent-teams/commands/team-status.md

latest1.9 KB
Original Source

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.