Team Commands

CRUD for team lifecycle with worktree management.

`genie team create`

Create a new team with a git worktree.

genie team create <name> --repo <path> [--branch dev] [--wish <slug>] [--tmux-session <name>] [--no-spawn]

Terminal

$ genie team create auth-rewrite --repo . --wish add-oauth --branch dev
✅ Team "auth-rewrite" created
  Worktree: ~/.genie/worktrees/myapp/auth-rewrite
  Branch:   team/auth-rewrite (from dev)
  Wish:     add-oauth
  Leader spawned with wish context.

Options

Flag	Description	Default
`--repo <path>`	Path to the git repository	Required
`--branch <branch>`	Base branch to create from	`dev`
`--wish <slug>`	Wish slug — auto-spawns a team leader with wish context	—
`--tmux-session <name>`	tmux session name (avoids session explosion)	—
`--no-spawn`	Create team without spawning a leader agent	—

Pair --wish <slug> with an existing wish to auto-spawn a team leader preloaded with that wish’s context. Use --no-spawn when you want the team scaffold without burning tokens — handy for tests or staged rollouts.

The --wish flag is the fastest path from “I have a wish” to “work is happening.” It creates the worktree, checks out the branch, and hands the leader the WISH.md so it can dispatch execution groups immediately.

`genie team hire`

Add an agent to a team. Use council to hire all 10 council members at once.

genie team hire <agent> [--team <name>]

Terminal

$ genie team hire engineer --team auth-rewrite
Hired "engineer" to team "auth-rewrite".

$ genie team hire council --team auth-rewrite
Hired 10 council members to "auth-rewrite":
  + council-questioner
  + council-benchmarker
  + council-simplifier
  + council-sentinel
  + council-ergonomist
  + council-architect
  + council-operator
  + council-deployer
  + council-measurer
  + council-tracer

`genie team fire`

Remove an agent from a team.

genie team fire <agent> [--team <name>]

Terminal

$ genie team fire engineer --team auth-rewrite
Removed "engineer" from team "auth-rewrite".

`genie team ls`

List teams or show details for a specific team.

genie team ls [<name>]

Terminal

$ genie team ls
Teams:
  auth-rewrite    3 members   active
  dream-0324      5 members   active

$ genie team ls auth-rewrite
Team: auth-rewrite
  Repo:     ~/projects/myapp
  Worktree: ~/.genie/worktrees/myapp/auth-rewrite
  Branch:   team/auth-rewrite
  Members:
    team-lead   (leader)
    engineer    (agent)
    reviewer    (agent)

`genie team archive`

Archive a team. Preserves all data but kills active members.

genie team archive <name>

Terminal

$ genie team archive auth-rewrite
Archived team "auth-rewrite".
  Members terminated.
  Data preserved — use 'genie team unarchive' to restore.

`genie team unarchive`

Restore an archived team.

genie team unarchive <name>

Terminal

$ genie team unarchive auth-rewrite
Restored team "auth-rewrite".

`genie team disband`

Disband a team and clean up its worktree.

genie team disband <name>

Terminal

$ genie team disband auth-rewrite
Disbanded team "auth-rewrite".
  Worktree removed.
  Agents terminated.

genie team disband deletes the team’s worktree and terminates its agents. Uncommitted changes in the worktree are lost. If you only want to pause the team, use genie team archive — it preserves data and can be restored with unarchive.

`genie team done`

Mark a team’s work as complete.

genie team done <name>

Terminal

$ genie team done auth-rewrite
Marked team "auth-rewrite" as done.

`genie team blocked`

Mark a team as blocked.

genie team blocked <name>

Terminal

$ genie team blocked auth-rewrite
Marked team "auth-rewrite" as blocked.

`genie team cleanup`

Clean up orphaned team resources (stale worktrees, dead tmux sessions).

genie team cleanup [--dry-run]

Terminal

$ genie team cleanup
Cleaned up 2 orphaned worktrees and 1 dead tmux session.

Auto-Detection

When --team is omitted, genie auto-detects the team from the leader context (environment variables or tmux session).

Teams (concept)

How teams, worktrees, and leaders fit together.

Spawn & Lifecycle

Spawn, stop, resume, and kill the individual agents within a team.

Dispatch

Dispatch wish-aware commands (wish, work, review) that the leader uses.

Messaging

Send instructions to team members while work is in flight.

Getting Started

Core Concepts

The Genie Loop

Power Skills

CLI Reference

Configuration

Security & Trust

Architecture

Observability

Hacks & Tips

Contributing

Team

Team Commands

`genie team create`

Options

`genie team hire`

`genie team fire`

`genie team ls`

`genie team archive`

`genie team unarchive`

`genie team disband`

`genie team done`

`genie team blocked`

`genie team cleanup`

Auto-Detection

See also

Teams (concept)

Spawn & Lifecycle

Dispatch

Messaging

​Team Commands

​genie team create

​Options

​genie team hire

​genie team fire

​genie team ls

​genie team archive

​genie team unarchive

​genie team disband

​genie team done

​genie team blocked

​genie team cleanup

​Auto-Detection

​See also

Teams (concept)

Spawn & Lifecycle

Dispatch

Messaging

Team Commands

`genie team create`

Options

`genie team hire`

`genie team fire`

`genie team ls`

`genie team archive`

`genie team unarchive`

`genie team disband`

`genie team done`

`genie team blocked`

`genie team cleanup`

Auto-Detection

See also