| name | use-team |
| description | Apply a named ccteams agent team to the current project by running ccteams use <team-name>. |
| argument-hint | ["team-name"] |
| allowed-tools | Bash |
Apply the agent team specified by the user's argument to the current project.
Steps:
-
If no team name was provided, run ccteams list via Bash, show the output, and
ask the user which team they want to apply before proceeding.
-
Decide whether to pass --agent-teams:
- Pass
--agent-teams if the user's request uses any of these phrases or clear
synonyms: "agent-teams mode", "collaborative", "team mode", "teammates working
in parallel", "have them work together", "parallel teammates", "member messaging".
- Otherwise, run the plain form.
-
Run the appropriate command via Bash:
- With flag:
ccteams use <team-name> --agent-teams
- Without flag:
ccteams use <team-name>
--agent-teams enables Claude Code's experimental agent-teams feature
(CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in .claude/settings.json), which allows
teammates to message each other. It is opt-in; you never add it unless the user asked.
-
Relay ccteams's full output to the user — do not truncate or paraphrase it.
-
Explicitly repeat the session-restart instruction from ccteams's output:
agents load at session start only; the switch is NOT instantly active.
The user must run /exit then claude to activate the new team.