
team-overlord
Multi-agent swarm management plugin for use by the Claude-litter tui manager
- GitHub stars
- 8
Install
/plugin install team-overlord@claude-litterRun it inside Claude Code after adding the marketplace with /plugin marketplace add Und3rf10w/claude-litter.
Contents
Discovered from sourceSkills 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
create_team("my-team", "Building feature X")create_task("my-team", "Implement auth", "Add JWT authentication...")update_task("my-team", "1", owner="researcher")
Monitor progress
list_teams()— overview of all teamslist_tasks("my-team", "in_progress")— what's being worked onread_inbox("my-team", "researcher")— check agent's messages
Communicate with agents
send_message("my-team", "researcher", "Please prioritize the auth task")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
/spawnand/killcommands 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_taskto show details. - If one word is given, treat it as the team name — call
list_tasksto show all tasks for that team. - If empty, call
list_teamsfirst to get all team names, then calllist_tasksfor 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