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 (
.agents/teams/) defining goals, prompts, and tools. - 🛠️ Worker: Isolated runtime instances (
.worktrees/) with their own branch and session.
Let your AI agent set itself up. It only takes two steps:
- Install the Skill:
Replace
npx skills add JsonLee12138/agent-team -a <platform> -y
<platform>with your provider:claude,gemini,opencode, orcodex. - Tell your Agent:
"Install agent-team and initialize the project."
| 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 |
| 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 |
Manage your entire team through natural language. Your AI agent will handle the commands for you.
"Create a frontend-architect role to manage our UI infrastructure."
Pull in expert roles from this repository:
agent-team role-repo add JsonLee12138/agent-team"Create a worker for frontend-architect using Claude." This opens a new terminal window with an isolated worktree.
"Assign frontend-architect-001 to design the new auth flow." The agent will brainstorm a design doc before touching any code.
"Merge frontend-architect-001 and delete the worker."
Available in .agents/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.
role-creator: Interactively build new agent roles.brainstorming: Validates ideas via dialogue before implementation.
| Provider | CLI Value | Hook Support |
|---|---|---|
| Claude Code | claude |
✅ Full (Plugin) |
| Gemini CLI | gemini |
✅ Full (Extension) |
| OpenCode | opencode |
✅ Full (NPM Plugin) |
| OpenAI Codex | codex |
📖 CLI Reference
agent-team role list: Show local roles.agent-team role create <name>: Create a new role package.agent-team role-repo add <owner/repo>: Install roles from GitHub.
agent-team worker create <role>: Spin up a new worker.agent-team worker status: View active workers and tasks.agent-team worker assign <id> "<task>": Dispatch work.agent-team worker merge <id>: Sync worker changes back.
agent-team reply <id> "<msg>": Send message to worker.agent-team reply-main "<msg>": Worker talks back to main.
📂 Directory Structure
project-root/
├── .agents/teams/ <- Project-specific roles
├── .worktrees/ <- Isolated worker workspaces
├── roles-lock.json <- Remote role version locking
├── gemini-extension.json <- Extension manifest
└── hooks/ <- Shared lifecycle hooks
🌐 Environment Variables
| Variable | Default | Description |
|---|---|---|
AGENT_TEAM_BACKEND |
wezterm |
Terminal: wezterm or tmux. |
AGENT_TEAM_ROLE_HUB_URL |
https://... |
Ingest endpoint for analytics. |
AGENT_TEAM_ROLE_HUB_DEBUG |
0 |
Wait for ingest if set to 1. |
MIT © JsonLee