diff --git a/README.md b/README.md
index bdcf6d18..f024dfb3 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ go install github.com/steveyegge/gastown/cmd/gt@latest
 gt install ~/gt
 
 # Add a project
-gt rig add myproject --remote=https://github.com/you/repo.git
+gt rig add myproject https://github.com/you/repo.git
 
 # Create a convoy and sling work (standard workflow)
 gt convoy create "Feature X" issue-123 issue-456 --notify --human
@@ -58,7 +58,9 @@ Town (~/gt/)              Your workspace
 ## Workflows
 
 ### Minimal (No Tmux)
+
 Run individual Claude Code instances manually. Gas Town just tracks state.
+
 ```bash
 gt convoy create "Fix bugs" issue-123  # Create convoy (sling auto-creates if skipped)
 gt sling issue-123 myproject           # Assign to worker
@@ -67,7 +69,9 @@ gt convoy list                         # Check progress
 ```
 
 ### Full Stack (Tmux)
+
 Agents run in tmux sessions. Daemon manages lifecycle.
+
 ```bash
 gt daemon start                        # Start lifecycle manager
 gt convoy create "Feature X" issue-123 issue-456
@@ -77,7 +81,9 @@ gt convoy list                         # Dashboard view
 ```
 
 ### Pick Your Roles
+
 Gas Town is modular. Run what you need:
+
 - **Polecats only**: Manual spawning, no monitoring
 - **+ Witness**: Automatic worker lifecycle, stuck detection
 - **+ Refinery**: Merge queue, code review
diff --git a/docs/INSTALLING.md b/docs/INSTALLING.md
index 180c8b7e..4effa045 100644
--- a/docs/INSTALLING.md
+++ b/docs/INSTALLING.md
@@ -111,7 +111,7 @@ gt install ~/gt
 
 ```bash
 # Add your first project
-gt rig add myproject --remote=https://github.com/you/repo.git
+gt rig add myproject https://github.com/you/repo.git
 
 # This clones the repo and sets up:
 #   ~/gt/myproject/
diff --git a/docs/reference.md b/docs/reference.md
index 22524b34..35aa79d6 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -21,6 +21,7 @@ Technical reference for Gas Town internals. Read the README first.
 ```
 
 **Key points:**
+
 - Rig root is a container, not a clone
 - `.repo.git/` is bare - refinery and polecats are worktrees
 - Mayor clone holds canonical `.beads/`, others inherit via redirect
@@ -50,6 +51,7 @@ Debug routing: `BD_DEBUG_ROUTING=1 bd show <id>`
 ## Configuration
 
 ### Rig Config (`config.json`)
+
 ```json
 {
   "type": "rig",
@@ -60,6 +62,7 @@ Debug routing: `BD_DEBUG_ROUTING=1 bd show <id>`
 ```
 
 ### Settings (`settings/config.json`)
+
 ```json
 {
   "theme": "desert",
@@ -69,6 +72,7 @@ Debug routing: `BD_DEBUG_ROUTING=1 bd show <id>`
 ```
 
 ### Runtime (`.runtime/` - gitignored)
+
 Process state, PIDs, ephemeral data.
 
 ## Formula Format
@@ -91,6 +95,7 @@ needs = ["other-step"]      # Dependencies
 ```
 
 **Composition:**
+
 ```toml
 extends = ["base-formula"]
 
@@ -165,6 +170,7 @@ gt mol step done <step>      # Complete a molecule step
 ## Agent Lifecycle
 
 ### Polecat Shutdown
+
 ```
 1. Complete work steps
 2. bd mol squash (create digest)
@@ -175,6 +181,7 @@ gt mol step done <step>      # Complete a molecule step
 ```
 
 ### Session Cycling
+
 ```
 1. Agent notices context filling
 2. gt handoff (sends mail to self)
@@ -200,6 +207,7 @@ gt mol step done <step>      # Complete a molecule step
 ## CLI Reference
 
 ### Town Management
+
 ```bash
 gt install [path]            # Create town
 gt install --git             # With git init
@@ -208,13 +216,15 @@ gt doctor --fix              # Auto-repair
 ```
 
 ### Rig Management
+
 ```bash
-gt rig add <name> --remote=<url>
+gt rig add <name> <url>
 gt rig list
 gt rig remove <name>
 ```
 
 ### Convoy Management (Primary Dashboard)
+
 ```bash
 gt convoy list                          # Dashboard of active convoys
 gt convoy status [convoy-id]            # Show progress (🚚 hq-cv-*)
@@ -227,6 +237,7 @@ gt convoy list --status=closed          # Only landed convoys
 Note: "Swarm" is ephemeral (workers on a convoy's issues). See [Convoys](convoy.md).
 
 ### Work Assignment
+
 ```bash
 # Standard workflow: convoy first, then sling
 gt convoy create "Feature X" gt-abc gt-def
@@ -238,6 +249,7 @@ gt sling <bead> <rig>                    # Auto-convoy for dashboard visibility
 ```
 
 ### Communication
+
 ```bash
 gt mail inbox
 gt mail read <id>
@@ -246,6 +258,7 @@ gt mail send --human -s "..."    # To overseer
 ```
 
 ### Escalation
+
 ```bash
 gt escalate "topic"              # Default: MEDIUM severity
 gt escalate -s CRITICAL "msg"    # Urgent, immediate attention
@@ -256,6 +269,7 @@ gt escalate -s MEDIUM "msg" -m "Details..."
 See [escalation.md](escalation.md) for full protocol.
 
 ### Sessions
+
 ```bash
 gt handoff                   # Request cycle (context-aware)
 gt handoff --shutdown        # Terminate (polecats)
@@ -269,9 +283,11 @@ gt seance --talk <id> -p "Where is X?"  # One-shot question
 
 **Session Discovery**: Each session has a startup nudge that becomes searchable
 in Claude's `/resume` picker:
+
 ```
 [GAS TOWN] recipient <- sender • timestamp • topic[:mol-id]
 ```
+
 Example: `[GAS TOWN] gastown/crew/gus <- human • 2025-12-30T15:42 • restart`
 
 **IMPORTANT**: Always use `gt nudge` to send messages to Claude sessions.
@@ -279,6 +295,7 @@ Never use raw `tmux send-keys` - it doesn't handle Claude's input correctly.
 `gt nudge` uses literal mode + debounce + separate Enter for reliable delivery.
 
 ### Emergency
+
 ```bash
 gt stop --all                # Kill all sessions
 gt stop --rig <name>         # Kill rig sessions
@@ -327,6 +344,7 @@ Plugins are molecules with specific labels:
 ```
 
 Patrol molecules bond plugins dynamically:
+
 ```bash
 bd mol bond mol-security-scan $PATROL_ID --var scope="$SCOPE"
 ```
diff --git a/internal/cmd/rig.go b/internal/cmd/rig.go
index 52fd60a1..9ff222ba 100644
--- a/internal/cmd/rig.go
+++ b/internal/cmd/rig.go
@@ -268,7 +268,7 @@ func runRigAdd(cmd *cobra.Command, args []string) error {
 	fmt.Printf("  └── polecats/\n")
 
 	fmt.Printf("\nNext steps:\n")
-	fmt.Printf("  gt crew add <name> %s   # Create your workspace\n", name)
+	fmt.Printf("  gt crew add <name> --rig %s   # Create your workspace\n", name)
 	fmt.Printf("  cd %s/crew/<name>       # Work in your clone\n", filepath.Join(townRoot, name))
 
 	return nil