Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.automagik.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
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

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—
--tmux-session <name>tmux session name (avoids session explosion)—
--no-spawnCreate 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).

​
See also

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.