Skip to main content
command CX Codex

team-delegate — Claude Code command: team task distribution

team-delegate displays team workload dashboard, assigns tasks to members, and rebalances load via --assign, --message, and --rebalance flags.

MIT ★ 42,780 updated 2026-10-24

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add wshobson/agents
/plugin install agent-teams@claude-code-workflows
Open on GitHub

What team-delegate does

The command reads team config from ~/.claude/teams/{team-name}/config.json and current task list to display unassigned tasks, member workloads, blocked tasks, and rebalancing suggestions. The --assign task-id=member-name flag assigns a task to a member and sends a notification. The --rebalance flag analyzes load, identifies overloaded members (3+ tasks) and idle members (0 tasks), and suggests reassignments. Without flags, it outputs the full delegation dashboard.

Requires a configured team in ~/.claude/teams/ and works with built-in TaskList, TaskUpdate, and SendMessage tools. For ad-hoc delegation, Claude Code has a built-in delegate mode accessible via Shift+Tab.

What it helps with

  • see who is overloaded and who is idle
  • assign a task to a specific member and notify them
  • rebalance workload across team members
  • find blocked tasks and their dependencies
  • send a message to a team member

Example prompts for the agent

  • Show delegation dashboard for backend-team
  • Assign task 5 to implementer-3 with /team-delegate backend-team --assign 5=implementer-3
  • Analyze team load and suggest rebalancing via /team-delegate backend-team --rebalance

How to install team-delegate

1Plugin marketplace

/plugin marketplace add wshobson/agents
/plugin install agent-teams@claude-code-workflows

2Manually: put the files in place

.claude/commands/team-delegate.md

Call it with /team-delegate. For all projects use ~/.claude/commands/

Questions about team-delegate

How to install team-delegate in Claude Code?

Run /plugin marketplace add wshobson/agents, then /plugin install agent-teams@claude-code-workflows. The command will appear in .claude/commands/team-delegate.md.

What does team-delegate do?

The command displays team workload, assigns tasks to members, sends notifications, and suggests load rebalancing based on the current task list.

What does team-delegate require?

It requires a team config file in ~/.claude/teams/{team-name}/config.json. The command uses Claude Code's built-in tools for tasks and messages.

Source text

team-delegate.md · MIT
---
description: "Task delegation dashboard for managing team workload, assignments, and rebalancing"
argument-hint: "[team-name] [--assign task-id=member-name] [--message member-name 'content'] [--rebalance]"
---

# Team Delegate

Manage task assignments and team workload. Provides a delegation dashboard showing unassigned tasks, member workloads, blocked tasks, and rebalancing suggestions.

## Pre-flight Checks

1. Parse `$ARGUMENTS` for team name and action flags:
   - `--assign task-id=member-name`: assign a specific task to a member
   - `--message member-name 'content'`: send a message to a specific member
   - `--rebalance`: analyze and rebalance workload distribution

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

## Action: Assign Task

If `--assign` flag is provided:

1. Parse task ID and member name from `task-id=member-name` format
2. Use `TaskUpdate` to set the task owner
3. Use `SendMessage` with `type: "message"` to notify the member:
   - recipient: member name
   - content: "You've been assigned task #{id}: {subject}. {task description}"
4. Confirm: "Task #{id} assigned to {member-name}"

## Action: Send Message

If `--message` flag is provided:

1. Parse member name and message content
2. Use `SendMessage` with `type: "message"`:
   - recipient: member name
   - content: the message content
3. Confirm: "Message sent to {member-name}"

## Action: Rebalance

If `--rebalance` flag is provided:

1. Analyze current workload distribution:
   - Count tasks per member (in_progress + pending assigned)
   - Identify members with 0 tasks (idle)
   - Identify members with 3+ tasks (overloaded)
   - Check for blocked tasks that could be unblocked

2. Generate rebalancing suggestions:

   ```
   ## Workload Analysis

   Member          Tasks    Status
   ─────────────────────────────────
   implementer-1   3        overloaded
   implementer-2   1        balanced
   implementer-3   0        idle

   Suggestions:
   1. Move task #5 from implementer-1 to implementer-3
   2. Assign unassigned task #7 to implementer-3
   ```

3. Ask user for confirmation before executing rebalancing
4. Execute approved moves with `TaskUpdate` and `SendMessage`

## Default: Delegation Dashboard

If no action flag is provided, display the full delegation dashboard:

```
## Delegation Dashboard: {team-name}

### Unassigned Tasks
  #5  Review error handling patterns
  #7  Add integration tests

### Member Workloads
  implementer-1   3 tasks (1 in_progress, 2 pending)
  implementer-2   1 task  (1 in_progress)
  implementer-3   0 tasks (idle)

### Blocked Tasks
  #6  Blocked by #4 (in_progress, owner: implementer-1)

### Suggestions
  - Assign #5 to implementer-3 (idle)
  - Assign #7 to implementer-2 (low workload)
```

**Tip**: Use Shift+Tab to enter Claude Code's built-in delegate mode for ad-hoc task delegation.

© Seth Hobson · MIT · wshobson/agents

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set513

The whole set →
team-spawn team-spawn — a slash command for Claude Code, Codex, and Cursor that assembles a multi-agent team from a preset or custom composition. Seven presets cover review, debug, feature work, full-stack, research, security audit, and migration. CX Codex +1 ★ 42,780repo stars team-shutdown team-shutdown stops an agent team, gathers final responses, and cleans up its resources. Use it when an active team needs a controlled shutdown. CX Codex +1 ★ 42,780repo stars team-review team-review spawns several reviewers at once, each on its own quality dimension, and returns one report sorted by severity. CX Codex +1 ★ 42,780repo stars team-feature team-feature orchestrates parallel feature development across multiple Claude Code agents with strict file ownership boundaries. CX Codex +1 ★ 42,780repo stars team-debug team-debug is a command for Claude Code, Codex, and Cursor that investigates bugs by running one agent per hypothesis in parallel and ranking findings by confidence. CX Codex +1 ★ 42,780repo stars team-reviewer team-reviewer is a Claude Code subagent for focused code reviews, examining one area such as security, performance, architecture, testing, or accessibility and reporting exact line citations with suggested fixes. CX Codex ★ 42,780repo stars team-lead team-lead is a subagent orchestrator for Claude Code and Codex that splits complex tasks into parallel subtasks with separate file ownership, then merges the results. CX Codex ★ 42,780repo stars team-implementer team-implementer — a subagent that builds its slice of a feature inside assigned file boundaries and coordinates with other agents at integration points. CX Codex ★ 42,780repo stars

Project sponsors

Companies that keep this analytics open