@hyperdrive.bot/gut 0.1.14-alpha.0 → 0.1.15

package/README.md

@@ -18,7 +18,7 @@ $ npm install -g @hyperdrive.bot/gut
 $ gut COMMAND
 running command...
 $ gut (--version)
-@hyperdrive.bot/gut/0.1.14-alpha.0 linux-x64 node-v22.22.2
+@hyperdrive.bot/gut/0.1.15-alpha.0 linux-x64 node-v22.22.2
 $ gut --help [COMMAND]
 USAGE
   $ gut COMMAND
@@ -72,6 +72,11 @@ USAGE
 * [`gut used-by [ENTITY]`](#gut-used-by-entity)
 * [`gut workspace ACTION`](#gut-workspace-action)
 * [`gut worktree create NAME`](#gut-worktree-create-name)
+* [`gut worktree gc`](#gut-worktree-gc)
+* [`gut worktree list`](#gut-worktree-list)
+* [`gut worktree prune`](#gut-worktree-prune)
+* [`gut worktree remove NAME`](#gut-worktree-remove-name)
+* [`gut worktree status [NAME]`](#gut-worktree-status-name)
 
 ## `gut add [PATH]`
 
@@ -1215,4 +1220,101 @@ EXAMPLES
 
   GUT_WORKTREE_DIR=/tmp/gut-worktrees gut worktree create feature/ci-run
 ```
+
+## `gut worktree gc`
+
+Remove worktrees older than a given duration (garbage collection)
+
+```
+USAGE
+  $ gut worktree gc -o <value> [-n] [-f]
+
+FLAGS
+  -f, --force               Remove even worktrees with uncommitted changes
+  -n, --dry-run             List candidates without removing anything
+  -o, --older-than=<value>  (required) Duration threshold (e.g. '7d', '24h', '30m', '90s')
+
+DESCRIPTION
+  Remove worktrees older than a given duration (garbage collection)
+
+EXAMPLES
+  $ gut worktree gc --older-than 7d
+
+  $ gut worktree gc --older-than 14d --force
+
+  $ gut worktree gc --older-than 7d --dry-run
+```
+
+## `gut worktree list`
+
+List all active worktrees with metadata and staleness detection
+
+```
+USAGE
+  $ gut worktree list
+
+DESCRIPTION
+  List all active worktrees with metadata and staleness detection
+
+EXAMPLES
+  $ gut worktree list
+```
+
+## `gut worktree prune`
+
+Remove worktree records whose paths no longer exist on disk
+
+```
+USAGE
+  $ gut worktree prune
+
+DESCRIPTION
+  Remove worktree records whose paths no longer exist on disk
+
+EXAMPLES
+  $ gut worktree prune
+```
+
+## `gut worktree remove NAME`
+
+Remove a worktree and all entity worktrees
+
+```
+USAGE
+  $ gut worktree remove NAME [-f]
+
+ARGUMENTS
+  NAME  Worktree name to remove
+
+FLAGS
+  -f, --force  Remove even with uncommitted changes
+
+DESCRIPTION
+  Remove a worktree and all entity worktrees
+
+EXAMPLES
+  $ gut worktree remove workflow/batch
+
+  $ gut worktree remove workflow/batch --force
+```
+
+## `gut worktree status [NAME]`
+
+Show per-entity git status for worktrees
+
+```
+USAGE
+  $ gut worktree status [NAME]
+
+ARGUMENTS
+  NAME  Worktree name (shows all if omitted)
+
+DESCRIPTION
+  Show per-entity git status for worktrees
+
+EXAMPLES
+  $ gut worktree status
+
+  $ gut worktree status workflow/deploy-batch
+```
 <!-- commandsstop -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/gut",
-  "version": "0.1.14-alpha.0",
+  "version": "0.1.15",
   "description": "Git Unified Tooling - Enhanced git with workspace intelligence for entity-based organization",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -93,4 +93,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}