agent-team

agent-team

English | 中文

Orchestrate your AI workforce with surgical precision. 🚀

agent-team is a multi-agent development manager that uses a Role + Worker model to run AI agents in isolated Git worktrees and dedicated terminal sessions.

• 🎭 Role: Reusable skill packages (.agent-team/teams/) defining goals, prompts, and tools.
• 🛠️ Worker: Isolated runtime instances (.worktrees/) with their own branch and session.

---

Table of Contents

• Installation
  • AI-Native (Recommended)
  • Manual Installation
• Upgrade
• Quick Start
• The Toolkit
• Supported Providers
• Advanced Usage
  • CLI Reference
  • Directory Structure
  • Environment Variables
• License

---

🛠️ Installation

🤖 AI-Native (Recommended)

Let your AI agent set itself up. It only takes two steps:

1. Install the Skill:

   npx skills add JsonLee12138/agent-team -a <platform> -y
   

   Replace <platform> with your provider: claude, gemini, opencode, or codex.
2. Tell your Agent:

   "Install agent-team and initialize the project."

---

📦 Manual Installation

Method	Command
Homebrew	brew tap JsonLee12138/agent-team && brew install agent-team
Go Install	go install github.com/JsonLee12138/agent-team@latest
Claude Plugin	/plugin marketplace add JsonLee12138/agent-team
Gemini Ext	gemini extensions install https://github.com/JsonLee12138/agent-team
OpenCode Plugin	{ "plugin": ["opencode-agent-team"] } in ~/.config/opencode/opencode.json

---

🔄 Upgrade

Method	Command
Claude Plugin	/plugin marketplace update agent-team
Skill	npx skills add JsonLee12138/agent-team -a '*' -y
Homebrew	brew update && brew upgrade agent-team
Go Install	go install github.com/JsonLee12138/agent-team@latest

---

🚀 Quick Start

Manage your entire team through natural language. Your AI agent will handle the commands for you.

1. Define your Team

"Create a frontend-architect role to manage our UI infrastructure."

2. Install Curated Roles (Optional)

Pull in expert roles from this repository:

agent-team role-repo add JsonLee12138/agent-team

3. Spawn a Worker

"Create a worker for frontend-architect using Claude." This opens a new terminal window with an isolated worktree.

4. Assign & Brainstorm

"Assign frontend-architect-001 to design the new auth flow." The agent will brainstorm a design doc before touching any code.

5. Merge & Cleanup

"Merge frontend-architect-001 and delete the worker."

---

🧰 The Toolkit

Built-in Roles

Available in .agent-team/teams/:

• pm: Product Manager & Requirement Shaping.
• frontend-architect: High-level UI/UX structure.
• vite-react-dev: Specialized for Vite + React.
• pencil-designer: UI design tool specialist.

Built-in Skills

• task-orchestrator: Task lifecycle entry.
• workflow-orchestrator: Governance-only workflow plan entry.
• worker-dispatch: Controller-side worker open/reply entry.
• worker-recovery: Worker-first resume entry.
• worker-reply-main: Worker -> main reporting entry.
• context-cleanup: Session cleanup + index-first file re-anchoring.
• task-inspector: Read-only task inspection.
• role-repo-manager: Role source management.
• catalog-browser: Read-only catalog browsing.
• project-bootstrap: init / migrate entry.
• rules-maintenance: rules sync entry.
• skill-maintenance: Skill cache maintenance.
• worker-inspector: Read-only worker status.
• role-browser: Read-only local role browsing.
• role-creator: Interactively build new agent roles.
• brainstorming: Validates ideas via dialogue before implementation, including planning-target selection (roadmap / milestone / phase / task / generic topic) and explicit save-destination choices (docs/brainstorming/, target-object directory, custom path, or skip saving).
• agent-team: Legacy compatibility shell that now routes to the dedicated scenario skills.

---

🤖 Supported Providers

Provider	CLI Value	Integration
Claude Code	claude	Plugin
Gemini CLI	gemini	Extension
OpenCode	opencode	NPM Plugin
OpenAI Codex	codex	Prompt-only

---

⚙️ Advanced Usage

📖 CLI Reference