Skip to main content

​
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>] [--session <name>]
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

FlagDescriptionDefault
--repo <path>Path to the git repositoryRequired
--branch <branch>Base branch to create fromdev
--wish <slug>Wish slug — auto-spawns a team leader with wish context—
--session <name>Tmux session name (avoids session explosion)—

​
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    (worker)
    reviewer    (worker)

​
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 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.

​
Auto-Detection

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