@gw-tools/gw 0.20.3 → 0.20.4

package/README.md

@@ -91,6 +91,8 @@ A command-line tool for managing git worktrees, built with Deno.
 
 ## Quick Start
 
+**New Project Setup:**
+
 ```bash
 # Install (Homebrew on macOS)
 brew install mthines/gw-tools/gw && gw install-shell
@@ -101,25 +103,27 @@ npm install -g @gw-tools/gw && gw install-shell
 # Or install via Linux package manager
 yay -S gw-tools && gw install-shell
 
-# Create a new worktree and copy files
-gw add feat-new-feature .env secrets/
+# Clone a repository with gw setup (interactive prompts for configuration)
+gw init git@github.com:user/repo.git --interactive
+# Automatically navigates to the new repository
 
-# Navigate to your new worktree
+# Create worktrees and start working
+gw add feat-new-feature
 gw cd feat-new-feature
-
-# Or checkout an existing branch (navigates if already checked out elsewhere)
-gw checkout main
 ```
 
-**Or with auto-copy (one-time setup):**
+**Existing Repository Setup:**
 
 ```bash
-# Configure auto-copy files once per repository
-gw init --root $(gw root) --auto-copy-files .env,secrets/
+# Configure gw in an existing repository
+gw init --auto-copy-files .env,secrets/ --post-add "pnpm install"
 
-# Now just create worktrees - files are copied automatically
+# Create worktrees - files are copied automatically, dependencies installed
 gw add feat-another-feature
 gw cd feat-another-feature
+
+# Checkout an existing branch (navigates if already checked out elsewhere)
+gw checkout main
 ```
 
 ## Initial Setup: Secrets in the Default Branch
@@ -129,29 +133,47 @@ gw cd feat-another-feature
 ### First-Time Setup Flow
 
 ```bash
-# 1. Set up your bare repository structure
-git clone --bare https://github.com/user/repo.git repo.git
-cd repo.git
+# 1. Clone and set up repository with gw (interactive mode)
+gw init git@github.com:user/repo.git --interactive
 
-# 2. Create the main worktree (your defaultBranch)
-git worktree add main main
+# During interactive setup:
+# - Configure auto-copy files: .env,secrets/
+# - Set up post-add hooks if needed (e.g., pnpm install)
+# - Configure other options as desired
 
-# 3. Set up secrets in the main worktree FIRST
+# This automatically:
+# - Clones the repository
+# - Creates the gw_root branch
+# - Creates the main worktree
+# - Navigates you to the repository root
+
+# 2. Set up secrets in the main worktree FIRST
 cd main
 cp .env.example .env           # Create your environment file
 # Edit .env with your actual secrets, API keys, etc.
 mkdir -p secrets/
 # Add any other secret files your project needs
 
-# 4. Initialize gw with auto-copy configuration
-gw init --auto-copy-files .env,secrets/
-
-# 5. Now create feature worktrees - files are copied automatically from main
+# 3. Now create feature worktrees - files are copied automatically from main
 cd ..
 gw add feat-new-feature
 # .env and secrets/ are automatically copied from main to feat-new-feature
 ```
 
+**Alternative: Non-Interactive Setup**
+
+```bash
+# Clone with configuration in one command
+gw init git@github.com:user/repo.git \
+  --auto-copy-files .env,secrets/ \
+  --post-add "pnpm install"
+
+# Then set up secrets in main worktree as shown above
+cd repo.git/main
+cp .env.example .env
+# Edit .env with your secrets
+```
+
 ### Why This Matters
 
 - **`gw add`** copies files **from** your `defaultBranch` worktree **to** the new worktree
@@ -735,9 +757,11 @@ gw root
 
 ### init
 
-Initialize gw configuration for a git repository. This command can:
+Initialize gw configuration for a git repository. This is the recommended way to get started with gw.
+
+**Two modes:**
 
-1. **Clone mode**: Clone a repository and set it up with gw configuration
+1. **Clone mode**: Clone a repository and automatically set it up with gw (recommended for new projects)
 2. **Existing repo mode**: Initialize gw in an existing repository
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gw-tools/gw",
-  "version": "0.20.3",
+  "version": "0.20.4",
   "description": "A command-line tool for managing git worktrees - copy files between worktrees with ease",
   "keywords": [
     "git",