From 201ef3a9c8c3033f4ff59b7806b9c6756a2e4112 Mon Sep 17 00:00:00 2001
From: Martin Emde <martinemde@users.noreply.github.com>
Date: Tue, 6 Jan 2026 12:59:49 -0800
Subject: [PATCH] Replace `gt rigs` with `gt rig list` in templates and docs
 (#217)

The command was renamed from `gt rigs` to `gt rig` with subcommands.
This updates all references to use `gt rig list` for listing rigs.
---
 internal/cmd/prime.go                                      | 2 +-
 internal/cmd/worktree.go                                   | 4 ++--
 internal/formula/formulas/mol-digest-generate.formula.toml | 2 +-
 internal/formula/formulas/mol-orphan-scan.formula.toml     | 2 +-
 internal/formula/formulas/mol-town-shutdown.formula.toml   | 2 +-
 internal/templates/roles/mayor.md.tmpl                     | 2 +-
 npm-package/README.md                                      | 2 +-
 7 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/internal/cmd/prime.go b/internal/cmd/prime.go
index fcbe2130..4a9dd19e 100644
--- a/internal/cmd/prime.go
+++ b/internal/cmd/prime.go
@@ -371,7 +371,7 @@ func outputMayorContext(ctx RoleContext) {
 	fmt.Println("- `gt mail inbox` - Check your messages")
 	fmt.Println("- `gt mail read <id>` - Read a specific message")
 	fmt.Println("- `gt status` - Show overall town status")
-	fmt.Println("- `gt rigs` - List all rigs")
+	fmt.Println("- `gt rig list` - List all rigs")
 	fmt.Println("- `bd ready` - Issues ready to work")
 	fmt.Println()
 	fmt.Println("## Hookable Mail")
diff --git a/internal/cmd/worktree.go b/internal/cmd/worktree.go
index 1827b35b..0c447118 100644
--- a/internal/cmd/worktree.go
+++ b/internal/cmd/worktree.go
@@ -113,7 +113,7 @@ func runWorktree(cmd *cobra.Command, args []string) error {
 	// Verify target rig exists
 	_, targetRigInfo, err := getRig(targetRig)
 	if err != nil {
-		return fmt.Errorf("rig '%s' not found - run 'gt rigs' to see available rigs", targetRig)
+		return fmt.Errorf("rig '%s' not found - run 'gt rig list' to see available rigs", targetRig)
 	}
 
 	// Compute worktree path: ~/gt/<target-rig>/crew/<source-rig>-<name>/
@@ -305,7 +305,7 @@ func runWorktreeRemove(cmd *cobra.Command, args []string) error {
 	// Verify target rig exists
 	_, targetRigInfo, err := getRig(targetRig)
 	if err != nil {
-		return fmt.Errorf("rig '%s' not found - run 'gt rigs' to see available rigs", targetRig)
+		return fmt.Errorf("rig '%s' not found - run 'gt rig list' to see available rigs", targetRig)
 	}
 
 	// Compute worktree path: ~/gt/<target-rig>/crew/<source-rig>-<name>/
diff --git a/internal/formula/formulas/mol-digest-generate.formula.toml b/internal/formula/formulas/mol-digest-generate.formula.toml
index 0f4e0326..cc2bbc66 100644
--- a/internal/formula/formulas/mol-digest-generate.formula.toml
+++ b/internal/formula/formulas/mol-digest-generate.formula.toml
@@ -78,7 +78,7 @@ Gather activity data from each rig in the town.
 
 **1. List accessible rigs:**
 ```bash
-gt rigs
+gt rig list
 # Returns list of rigs: gastown, beads, etc.
 ```
 
diff --git a/internal/formula/formulas/mol-orphan-scan.formula.toml b/internal/formula/formulas/mol-orphan-scan.formula.toml
index 2bebf26c..3cc2235e 100644
--- a/internal/formula/formulas/mol-orphan-scan.formula.toml
+++ b/internal/formula/formulas/mol-orphan-scan.formula.toml
@@ -57,7 +57,7 @@ gt hook               # Shows scope in hook_bead
 
 ```bash
 # If town-wide
-gt rigs                     # Get list of all rigs
+gt rig list                 # Get list of all rigs
 
 # If specific rig
 # Just use that rig
diff --git a/internal/formula/formulas/mol-town-shutdown.formula.toml b/internal/formula/formulas/mol-town-shutdown.formula.toml
index 82f30ab2..74a1623f 100644
--- a/internal/formula/formulas/mol-town-shutdown.formula.toml
+++ b/internal/formula/formulas/mol-town-shutdown.formula.toml
@@ -85,7 +85,7 @@ Archive and clear all agent inboxes across all rigs.
 
 ```bash
 # For each rig
-for rig in $(gt rigs --names); do
+for rig in $(gt rig list --names); do
   gt mail clear $rig/witness --archive
   gt mail clear $rig/refinery --archive
 done
diff --git a/internal/templates/roles/mayor.md.tmpl b/internal/templates/roles/mayor.md.tmpl
index fdba3cd2..20991e95 100644
--- a/internal/templates/roles/mayor.md.tmpl
+++ b/internal/templates/roles/mayor.md.tmpl
@@ -188,7 +188,7 @@ bd show hq-abc      # Routes to town beads
 
 ### Status
 - `gt status` - Overall town status
-- `gt rigs` - List all rigs
+- `gt rig list` - List all rigs
 - `gt polecat list [rig]` - List polecats in a rig
 
 ### Work Management
diff --git a/npm-package/README.md b/npm-package/README.md
index ab7213a0..e0fe2907 100644
--- a/npm-package/README.md
+++ b/npm-package/README.md
@@ -23,7 +23,7 @@ gt init
 gt status
 
 # List rigs
-gt rigs
+gt rig list
 ```
 
 ## Supported Platforms