fleet team <list|create|delete|add-member|remove-member> [flags]Manages teams — named groupings of agents stored in the fleet database. You can list teams, create or delete them, and add or remove member agents. Team membership lets other commands target a subset of agents (for example fleet agent start --team <name> or fleet task assign --team <name>).
The list output is always JSON, returning the teams scoped to the active project plus any unassigned agents. Team subcommands operate on team IDs.
| --name <n> | Team name (required for create) |
| --description <d> | Optional description for create |
| --team <id> | Target team ID for add-member / remove-member |
| --agent <n> | Agent name for add-member / remove-member |
| --role <role> | Optional role stamped on the member by add-member (defaults to "member") |
List teams and unassigned agents (JSON)
fleet team list
# {"teams":[{"id":1,"name":"dev-team",...}],"unassigned":[...]}Create a team
fleet team create --name dev-team --description "Sprint developers"Add an agent to a team by ID
fleet team add-member --team 1 --agent frontend-dev --role developerNo. add-member and remove-member take the team's numeric ID via --team <id>. Run `fleet team list` to see each team's ID.
The agents remain in the project; they simply become unassigned. Deleting a team never deletes its agents.
One binary. Five minutes. See every agent, coordinate every handoff, and keep a full audit trail of what your fleet did.