Xpersona
Claim this agent
agentCLAWHUBUnverified

Claude Team

Orchestrate multiple Claude Code workers via iTerm2 using the claude-team MCP server. Spawn workers with git worktrees, assign beads issues, monitor progress, and coordinate parallel development work. Skill: Claude Team Owner: jalehman Summary: Orchestrate multiple Claude Code workers via iTerm2 using the claude-team MCP server. Spawn workers with git worktrees, assign beads issues, monitor progress, and coordinate parallel development work. Tags: latest:1.5.0 Version history: v1.5.0 | 2026-01-05T22:48:41.243Z Fixed plist: executable is claude-team not claude-team-mcp v1.4.0 | 2026-01-05T22:46:23.790Z Fixed plist

View on ClawHub

Rank

62

Safety

84

Downloads

4.1k

Updated

Apr 15, 2026

Version

1.5.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 4.1K downloads reported by the source. Last updated 4/15/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Apr 15, 2026
Adoption signal
4.1K downloadsadoption · observed Apr 15, 2026
Latest release
1.5.0release · observed Jan 5, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn7225r761s3scn2kv93fyek617yme1y:claude-team
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-jalehman-claude-team/snapshot"

Documentation

CLAWHUB

27,291 characters of source documentation, loaded on request.

Extracted files

2 files captured from the source.

SKILL.md

---
name: claude-team
description: Orchestrate multiple Claude Code workers via iTerm2 using the claude-team MCP server. Spawn workers with git worktrees, assign beads issues, monitor progress, and coordinate parallel development work.
homepage: https://github.com/Martian-Engineering/claude-team
metadata: {"clawdbot":{"emoji":"👥","os":["darwin"],"requires":{"bins":["mcporter"]}}}
---

# Claude Team

Claude-team is an MCP server that lets you spawn and manage teams of Claude Code sessions via iTerm2. Each worker gets their own terminal pane, optional git worktree, and can be assigned beads issues.

## Why Use Claude Team?

- **Parallelism**: Fan out work to multiple agents working simultaneously
- **Context isolation**: Each worker has fresh context, keeps coordinator context clean
- **Visibility**: Real Claude Code sessions you can watch, interrupt, or take over
- **Git worktrees**: Each worker can have an isolated branch for their work

## ⚠️ Important Rule

**NEVER make code changes directly.** Always spawn workers for code changes. This keeps your context clean and provides proper git workflow with worktrees.

## Prerequisites

- macOS with iTerm2 (Python API enabled: Preferences → General → Magic → Enable Python API)
- claude-team MCP server configured in `~/.claude.json`

## Using via mcporter

All tools are called through `mcporter call claude-team.<tool>`:

```bash
mcporter call claude-team.list_workers
mcporter call claude-team.spawn_workers workers='[{"project_path":"/path/to/repo","bead":"cp-123"}]'
```

## Core Tools

### spawn_workers

Create new Claude Code worker sessions.

```bash
mcporter call claude-team.spawn_workers \
  workers='[{
    "project_path": "/path/to/repo",
    "bead": "cp-123",
    "annotation": "Fix auth bug",
    "use_worktree": true,
    "skip_permissions": true
  }]' \
  layout="auto"
```

**Worker config fields:**
- `project_path`: Required. Path to repo or "auto" (uses CLAUDE_TEAM_PROJECT_DIR)
- `bead`: Optional beads issue ID — worker will follow beads workflow
- `annotation`: Task description (shown on badge, used in branch name)
- `prompt`: Additional instructions (if no bead, this is their assignment)
- `use_worktree`: Create isolated git worktree (default: true)
- `skip_permissions`: Start with --dangerously-skip-permissions (default: false)
- `name`: Optional worker name override (auto-picks from themed sets otherwise)

**Layout options:**
- `"auto"`: Reuse existing claude-team windows, split into available space
- `"new"`: Always create fresh window (1-4 workers in grid layout)

### list_workers

See all managed workers:

```bash
mcporter call claude-team.list_workers
mcporter call claude-team.list_workers status_filter="ready"
```

Status values: `spawning`, `ready`, `busy`, `closed`

### message_workers

Send messages to one or more workers:

```bash
mcporter call claude-team.message_workers \
  session_ids='["Groucho"]' \
  message="Please also add unit tests" \
  wait_mode="none"
```

**wait_mode o

_meta.json

{
  "ownerId": "kn7225r761s3scn2kv93fyek617yme1y",
  "slug": "claude-team",
  "version": "1.5.0",
  "publishedAt": 1767653321243
}

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/jalehman/claude-team",
      "sourceUrl": "https://clawhub.ai/jalehman/claude-team",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "4.1K downloads",
      "href": "https://clawhub.ai/jalehman/claude-team",
      "sourceUrl": "https://clawhub.ai/jalehman/claude-team",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.5.0",
      "href": "https://clawhub.ai/jalehman/claude-team",
      "sourceUrl": "https://clawhub.ai/jalehman/claude-team",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-01-05T22:48:41.243Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-jalehman-claude-team/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jalehman-claude-team/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.5.0",
      "description": "Fixed plist: executable is claude-team not claude-team-mcp",
      "href": "https://clawhub.ai/jalehman/claude-team",
      "sourceUrl": "https://clawhub.ai/jalehman/claude-team",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-01-05T22:48:41.243Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to Claude Team and adjacent AI workflows.

Claude Team | Xpersona Agent