@gw-tools/gw 0.12.9 → 0.12.11

package/README.md

@@ -39,6 +39,10 @@ A command-line tool for managing git worktrees, built with Deno.
       - [Arguments](#arguments-2)
       - [Options](#options-3)
       - [Examples](#examples-5)
+    - [clean](#clean)
+      - [Options](#options-4)
+      - [Examples](#examples-6)
+      - [How It Works](#how-it-works-2)
     - [Git Worktree Proxy Commands](#git-worktree-proxy-commands)
       - [list (ls)](#list-ls)
       - [remove (rm)](#remove-rm)
@@ -174,6 +178,8 @@ gw init --root /path/to/your/repo.git
 }
 ```
 
+**More Examples**: See the [examples/](./examples/) directory for configuration templates for various project types (Next.js, Node.js API, monorepos, CI/CD, etc.).
+
 ### Configuration Options
 
 - **root**: Absolute path to the git repository root (automatically detected or manually set with `gw init`)
@@ -196,6 +202,9 @@ gw add <worktree-name> [files...]
 
 This command wraps `git worktree add` and optionally copies files to the new worktree. If `autoCopyFiles` is configured, those files are automatically copied. You can override this by specifying files as arguments.
 
+**Branch Creation Behavior:**
+When creating a new worktree without specifying an existing branch, `gw add` automatically fetches the latest version of your default branch (e.g., `main`) from the remote (e.g., `origin/main`) to ensure your new branch is based on the most recent code. If the remote is unavailable (no network or no remote configured), it gracefully falls back to using the local branch with a warning message.
+
 #### Arguments
 
 - `<worktree-name>`: Name or path for the new worktree
@@ -411,6 +420,7 @@ gw init [options]
 - `--auto-copy-files <files>`: Comma-separated list of files to auto-copy when creating worktrees with `gw add`
 - `--pre-add <command>`: Command to run before `gw add` creates a worktree (can be specified multiple times)
 - `--post-add <command>`: Command to run after `gw add` creates a worktree (can be specified multiple times)
+- `--clean-threshold <days>`: Number of days before worktrees are considered stale for `gw clean` (default: 7)
 - `-h, --help`: Show help message
 
 #### Examples
@@ -437,8 +447,11 @@ gw init --default-source master
 # Initialize with explicit repository root
 gw init --root /Users/username/Workspace/my-project.git
 
+# Initialize with custom clean threshold (14 days instead of default 7)
+gw init --clean-threshold 14
+
 # Full configuration example
-gw init --auto-copy-files .env,secrets/ --post-add "pnpm install"
+gw init --auto-copy-files .env,secrets/ --post-add "pnpm install" --clean-threshold 14
 
 # Show help
 gw init --help
@@ -457,6 +470,7 @@ Hooks support variable substitution:
 Use `gw init` to:
 - Configure auto-copy files for automatic file copying on worktree creation
 - Set up pre-add and post-add hooks for automation
+- Configure the clean threshold for worktree age management
 - Override the auto-detected repository root (rare)
 - Change the default source worktree from "main" to something else
 

package/package.json

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