@gw-tools/gw 0.12.15 → 0.12.17

package/README.md

@@ -39,6 +39,10 @@ A command-line tool for managing git worktrees, built with Deno.
       - [Options](#options-3)
       - [Examples](#examples-5)
       - [When to Use](#when-to-use)
+    - [show-init](#show-init)
+      - [Options](#options-6)
+      - [Examples](#examples-8)
+      - [When to Use](#when-to-use-1)
     - [sync](#sync)
       - [Arguments](#arguments-2)
       - [Options](#options-4)
@@ -98,6 +102,55 @@ gw add feat-another-feature
 gw cd feat-another-feature
 ```
 
+## Initial Setup: Secrets in the Default Branch
+
+**Important:** Before using `gw add` with auto-copy, ensure your secrets and environment files exist in your `defaultBranch` worktree (typically `main`). This worktree is the **source** from which files are copied to new worktrees.
+
+### 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
+
+# 2. Create the main worktree (your defaultBranch)
+git worktree add main main
+
+# 3. 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
+cd ..
+gw add feat-new-feature
+# .env and secrets/ are automatically copied from main to feat-new-feature
+```
+
+### Why This Matters
+
+- **`gw add`** copies files **from** your `defaultBranch` worktree **to** the new worktree
+- **`gw sync`** also uses `defaultBranch` as the source (unless `--from` is specified)
+- **Auto-clean** will **never** remove the `defaultBranch` worktree, ensuring your source files are always available
+- If secrets don't exist in `defaultBranch`, they won't be copied to new worktrees
+
+### Keeping Secrets Updated
+
+When you update secrets in your `defaultBranch` worktree, sync them to existing worktrees:
+
+```bash
+# Sync all autoCopyFiles to an existing worktree
+gw sync feat-existing-branch
+
+# Or sync specific files
+gw sync feat-existing-branch .env
+```
+
 ## Features
 
 - **Quick navigation**: Navigate to worktrees instantly with smart partial matching (`gw cd feat` finds `feat-branch`)
@@ -490,6 +543,7 @@ gw init [options]
 
 #### Options
 
+- `-i, --interactive`: Interactively prompt for configuration options
 - `--root <path>`: Specify the git repository root path (optional, auto-detects if not provided)
 - `--default-source <name>`: Set the default source worktree (default: "main")
 - `--auto-copy-files <files>`: Comma-separated list of files to auto-copy when creating worktrees with `gw add`
@@ -502,6 +556,9 @@ gw init [options]
 #### Examples
 
 ```bash
+# Interactive mode - prompts for all configuration options
+gw init --interactive
+
 # Initialize with auto-detected root
 gw init
 
@@ -557,8 +614,9 @@ gw init --auto-clean --auto-copy-files .env --post-add "pnpm install"
 ```
 
 **How it works:**
-- Runs automatically on `gw add` and `gw list` commands
+- Runs automatically on `gw add` and `gw list` commands (in the background, non-blocking)
 - Only runs once per 24 hours (cooldown)
+- **Never removes the `defaultBranch` worktree** - it's protected as the source for file syncing
 - Removes worktrees older than `cleanThreshold` with:
   - No uncommitted changes
   - No staged files
@@ -579,6 +637,67 @@ Use `gw init` to:
 
 The config file is created at `.gw/config.json` at the git root, so it's shared across all worktrees.
 
+### show-init
+
+Generate a `gw init` command that matches your current configuration. This is useful for documentation or recreating the same configuration in another repository.
+
+```bash
+gw show-init [options]
+```
+
+#### Options
+
+- `-h, --help`: Show help message
+
+#### Examples
+
+```bash
+# Show the init command for current config
+gw show-init
+
+# Copy the command to clipboard (macOS)
+gw show-init | pbcopy
+
+# Copy the command to clipboard (Linux with xclip)
+gw show-init | xclip -selection clipboard
+
+# Save to a file
+gw show-init > init-command.txt
+
+# Add to your documentation
+echo "## Setup\n\n\`\`\`bash\n$(gw show-init)\n\`\`\`" >> README.md
+```
+
+#### Output Example
+
+If your `.gw/config.json` contains:
+```json
+{
+  "root": "/Users/username/Workspace/repo.git",
+  "defaultBranch": "main",
+  "autoCopyFiles": [".env", "secrets/"],
+  "hooks": {
+    "add": {
+      "post": ["pnpm install"]
+    }
+  },
+  "cleanThreshold": 7
+}
+```
+
+Then `gw show-init` will output:
+```bash
+gw init --root /Users/username/Workspace/repo.git --auto-copy-files .env,secrets/ --post-add 'pnpm install'
+```
+
+#### When to Use
+
+Use `gw show-init` to:
+- Document your setup in README files or team wikis
+- Share configuration commands with team members
+- Recreate the same configuration in another repository
+- Verify your current configuration settings as a single command
+
 ### sync
 
 Sync files and directories between worktrees, preserving directory structure.

package/package.json

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