# Multi-Agent Team Coordination

Creates agent teams, assigns tasks and tracks progress on a kanban board.

- Repository: https://github.com/HKUDS/ClawTeam (5547 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-05-09
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add HKUDS/ClawTeam --skill ClawTeam -g -a claude-code -y`
Codex: `npx skills add HKUDS/ClawTeam --skill ClawTeam -g -a codex -y`
Cursor: `npx skills add HKUDS/ClawTeam --skill ClawTeam -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/ClawTeam --skill ClawTeam -g -a gemini-cli -y`

## Description

This skill should be used when the user asks to "create a team", "spawn agents", "assign tasks", "coordinate multiple agents", "check team status", "view kanban board", "send messages between agents", "manage team tasks", "monitor team progress", or mentions "clawteam", legacy "oh", "multi-agent coordination", "team collaboration", "agent inbox", "task board", "spawn worker". This skill should also be triggered when the current task is complex enough to benefit from splitting into subtasks and delegating to multiple agents, for example when the user asks to "build a full-stack app", "refactor the entire codebase", "implement multiple features in parallel", or when the agent determines that the work scope exceeds what a single agent can efficiently handle alone. Provides comprehensive guidance for using the ClawTeam CLI to orchestrate multi-agent teams with task management, messaging, monitoring, runtime profiles, git context, and recovery tooling.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ClawTeam Multi-Agent Coordination

ClawTeam is a framework-agnostic CLI tool for coordinating multiple AI agents as a team.
It provides team/task management, inter-agent messaging, git worktree isolation, provider-aware
runtime profiles, git context injection, snapshots, and terminal-based monitoring dashboards.

All operations are performed via the `clawteam` CLI. Data is stored in `~/.clawteam/` by default.

## Installation

Check whether `clawteam` is already available:

```bash
clawteam --version
```

If the command is missing, install it and continue:

```bash
pip install clawteam
```

Requires Python 3.10+. For P2P transport support: `pip install "clawteam[p2p]"`.

## Prerequisites

- `tmux` installed (default spawn backend)
- A CLI coding agent such as `claude`, `codex`, `gemini`, `kimi`, `nanobot`, or `openclaw`
- A git repository for worktree isolation and context features
- Default dependencies installed if you want the TUI wizard (`clawteam profile wizard`)

## Core Concepts

**Teams**, Named groups of agents with one leader and zero or more workers.

**Inbox**, File-based message queue per agent. `receive` is destructive; `peek` is not.

**Tasks**, Shared task board with `pending`, `in_progress`, `completed`, and `blocked`.
Tasks support dependency chains and priorities.

**Profiles**, Reusable client/provider/runtime configs used by `spawn` and `launch`.

**Presets**, Shared provider templates used to generate one or more profiles.

**Context**, Git/worktree-aware context tools for overlap checks, recent changes, and prompt injection.

**Board**, Team dashboard with kanban tasks, inbox counts, and message history views, plus gource activity visualization.

## Quick Start

### Set Up a Team with Tasks

```bash
export CLAWTEAM_AGENT_ID="leader-001"
export CLAWTEAM_AGENT_NAME="leader"
export CLAWTEAM_AGENT_TYPE="leader"

The rest: https://github.com/HKUDS/ClawTeam/blob/HEAD/docs/skills/clawteam/SKILL.md