✨ Features

| Feature | Description | |---------|-------------| | 🤖 Multi-Model Collaboration | Configure multiple AI models to work together, each leveraging their strengths | | 🧠 Smart Task Distribution | Tech Lead analyzes tasks and automatically assigns them to the best-suited experts | | 🔗 Workflow Templates | 5 pre-built workflows: code generation, bug fixing, refactoring, review, documentation | | 🎯 Custom Experts | Define your own experts (Rust, K8s, Security, etc.) via environment variables | | 📊 Observability | Dashboard, cost estimation, and task planning preview | | 🌐 Proxy API Support | Custom Base URLs, compatible with various proxy services | | 📝 Collaboration History | Complete record of all collaborations with search support |

🚀 Quick Start

Installation

# Global install
npm install -g claude-team

# Or use directly with npx (no install needed)
npx claude-team

Basic Configuration

Add to your IDE's MCP configuration file:

{
  "mcpServers": {
    "claude-team": {
      "command": "npx",
      "args": ["-y", "claude-team"],
      "env": {
        "CLAUDE_TEAM_MAIN_KEY": "sk-your-api-key",
        "CLAUDE_TEAM_MAIN_URL": "https://api.openai.com/v1",
        "CLAUDE_TEAM_MAIN_MODEL": "gpt-4o",
        "CLAUDE_TEAM_MAIN_PROVIDER": "openai"
      }
    }
  }
}

Start Using

> Help me build a user login feature with the team

> Have the team optimize this code for performance

🎬 How It Works

User: "Optimize this SQL query for performance"

Tech Lead Analysis →
├── Creates: SQL Optimization Expert (powerful)
├── Creates: Index Analysis Expert (balanced)  
└── Workflow: sequential

User: "Build a settings page with dark mode"

Tech Lead Analysis →
├── Creates: UI Component Expert (balanced)
├── Creates: Theme System Expert (fast)
├── Creates: State Management Expert (balanced)
└── Workflow: parallel → review

🛠️ Available Tools

Core Tools

| Tool | Description | |------|-------------| | team_work | 🚀 Team collaboration (auto-creates experts) | | ask_expert | 💬 Consult an expert (supports custom experts) | | code_review | 🔍 Code review | | fix_bug | 🐛 Bug fixing |

Workflow Tools

| Tool | Description | |------|-------------| | list_workflows | 📋 List all workflow templates | | run_workflow | ▶️ Execute a specific workflow | | suggest_workflow | 💡 Auto-recommend workflow based on task |

Pre-built Workflows:

| Workflow | Purpose | Steps | |----------|---------|-------| | code-generation | Generate code from requirements | Design → Implement → Test → Review | | bug-fix | Diagnose and fix bugs | Diagnose → Fix → Verify | | refactoring | Code refactoring | Analyze → Plan → Execute → Review | | code-review | Multi-dimensional review | Security / Quality / Performance (parallel) | | documentation | Generate documentation | Analyze → Document |

Observability Tools

| Tool | Description | |------|-------------| | team_dashboard | 🎛️ View team status, experts, models, stats | | cost_estimate | 💰 Estimate task cost (tokens, price, time) | | explain_plan | 🧠 Preview task assignment plan | | usage_stats | 📈 View model usage statistics |

Integration Tools

| Tool | Description | |------|-------------| | read_project_files | 📄 Read project files for context | | analyze_project_structure | 🏗️ Analyze project structure and tech stack | | generate_commit_message | 📝 Generate commit message from diff |

History Tools

| Tool | Description | |------|-------------| | history_list | 📋 View collaboration history | | history_get | 📄 Get history details | | history_search | 🔎 Search history records | | history_context | 📚 Get recent context |

⚙️ Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CLAUDE_TEAM_MAIN_KEY | ✅ | Main model API Key | | CLAUDE_TEAM_MAIN_URL | ❌ | Main model API URL | | CLAUDE_TEAM_MAIN_MODEL | ❌ | Main model ID (default: gpt-4o) | | CLAUDE_TEAM_MAIN_PROVIDER | ❌ | Provider: openai / anthropic / gemini | | CLAUDE_TEAM_MODEL{N}_* | ❌ | Worker model N config (inherits from MAIN) | | CLAUDE_TEAM_CUSTOM_EXPERTS | ❌ | Custom experts (JSON format) |

N = 1, 2, 3... supports up to 10 worker models

Custom Experts

Define your own experts beyond the built-in frontend, backend, qa:

{
  "env": {
    "CLAUDE_TEAM_CUSTOM_EXPERTS": "{\"rust\":{\"name\":\"Rust Expert\",\"prompt\":\"You are a Rust expert...\",\"tier\":\"powerful\"},\"k8s\":{\"name\":\"K8s Expert\",\"prompt\":\"You are a Kubernetes expert...\",\"tier\":\"balanced\"}}"
  }
}

| Field | Required | Description | |-------|----------|-------------| | name | ✅ | Expert display name | | prompt | ✅ | Expert role description (System Prompt) | | tier | ❌ | Model tier: fast / balanced / powerful | | skills | ❌ | Skill tags array |

Model Tiers

| Tier | Use Case | Example Scenarios | |------|----------|-------------------| | fast | Simple, quick tasks | Formatting, simple queries, docs | | balanced | Regular dev tasks | Components, APIs, unit tests | | powerful | Complex reasoning | Architecture, optimization, security |

📦 Changelog

v0.4.0

• 🎯 Custom Experts - Define experts via environment variables
• 🔗 Workflow Templates - 5 pre-built workflows
• 📊 Observability - Dashboard, cost estimation, plan preview
• 🔌 Integration - Project file reading, structure analysis, commit messages
• 💡 Smart Recommendations - Auto-suggest workflows
• 🧪 Test Coverage - 155 test cases

v0.3.0

• 🔄 Task interrupt/resume support
• 💬 Multi-turn expert conversations
• 📊 Token counting and cost estimation
• 📋 Expert templates (6 built-in + custom)
• 🔔 Webhook notifications
• ⚡ Exponential backoff retry
• 🔧 Hot config reload

🤝 Contributing

Contributions are welcome! Please read our:

• Contributing Guide
• Code of Conduct
• Security Policy

📄 License

MIT