Multi-agent swarm management plugin for use by the Claude-litter tui manager

GitHub stars
8

Install

/plugin install team-overlord@claude-litter

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Und3rf10w/claude-litter.

Contents

Discovered from source

Skills 1

Team Management

Use the team-overlord MCP tools to manage Claude Code agent teams, tasks, and messages.

Available Tools

Read-only

  • list_teams — List all teams with members and status
  • get_team(team) — Get full team configuration
  • list_tasks(team, status?) — List tasks, optionally filtered by status (pending, in_progress, completed)
  • get_task(team, task_id) — Get a single task by ID
  • read_inbox(team, agent) — Read an agent's message inbox

Write

  • create_team(name, description?) — Create a new team with directories and config
  • create_task(team, subject, description?) — Create a task (auto-increments ID)
  • update_task(team, task_id, status?, owner?, subject?, description?) — Update task fields (only non-empty values are changed)
  • send_message(team, to, text) — Send a message to a specific agent
  • broadcast_message(team, text) — Send a message to all agents in a team

Data Schemas

Team Config (~/.claude/teams/<name>/config.json)

{
  "name": "team-name",
  "description": "",
  "createdAt": 1710000000000,
  "leadAgentId": "name@team",
  "leadSessionId": "uuid",
  "members": [
    {
      "agentId": "name@team",
      "name": "agent-name",
      "agentType": "worker",
      "model": "sonnet",
      "color": "blue",
      "cwd": "/path/to/project"
    }
  ]
}

Task (~/.claude/tasks/<team>/<id>.json)

{
  "id": "1",
  "subject": "Task title",
  "description": "Detailed description",
  "status": "pending|in_progress|completed",
  "owner": "agent-name",
  "blocks": ["2"],
  "blockedBy": []
}

Inbox Message (~/.claude/teams/<team>/inboxes/<agent>.json)

Array of messages:

{
  "from": "sender-name",
  "text": "message content",
  "timestamp": "ISO 8601",
  "read": false,
  "summary": "optional preview",
  "color": "optional badge color"
}

Common Workflows

Create a team and set up tasks

  1. create_team("my-team", "Building feature X")
  2. create_task("my-team", "Implement auth", "Add JWT authentication...")
  3. update_task("my-team", "1", owner="researcher")

Monitor progress

  1. list_teams() — overview of all teams
  2. list_tasks("my-team", "in_progress") — what's being worked on
  3. read_inbox("my-team", "researcher") — check agent's messages

Communicate with agents

  1. send_message("my-team", "researcher", "Please prioritize the auth task")
  2. broadcast_message("my-team", "Stand down — merging to main now")

Context

Each prompt includes a <team-context> block showing current team state (members, statuses, task counts). Use the tools to act on this state — the context block is read-only and reflects the latest disk state.

Limitations

  • Spawning/killing agents requires the TUI's AgentManager (live SDK sessions). Use /spawn and /kill commands for those operations.
  • All data is stored as JSON under ~/.claude/. Changes are immediately visible to the TUI via filesystem watching.

Commands 4

Use the broadcast_message tool from team-overlord. Parse $ARGUMENTS: first word = team name, remaining text = message content. Both are required — if either is missing, ask the user to provide them.

Use the send_message tool from team-overlord. Parse $ARGUMENTS: first word = team name, second word = agent name, remaining text = message content. All three are required — if any are missing, ask the user to provide them.

Use the team-overlord MCP tools. Parse $ARGUMENTS:

  • If two words are given, treat the first as team name and second as task ID — call get_task to show details.
  • If one word is given, treat it as the team name — call list_tasks to show all tasks for that team.
  • If empty, call list_teams first to get all team names, then call list_tasks for each team and show a combined overview.

Use the team-overlord MCP tools. If $ARGUMENTS is empty, call list_teams and display a summary of all teams. If a team name is given, call get_team with that name and show full details including members and their configuration.

MCP servers 1

Sponsors

Details

Marketplace
Und3rf10w/claude-litter
Source
plugins/team-overlord
Author
Und3rf10w
Category
Community

More from Und3rf10w/claude-litter

All 3