@gw-tools/gw 0.29.0 → 0.30.0

package/README.md

@@ -8,6 +8,7 @@ A command-line tool for managing git worktrees, built with Deno.
   - [Table of Contents](#table-of-contents)
   - [Quick Start](#quick-start)
   - [🎓 AI Skills (for Claude Code, Copilot, Cursor, etc.)](#-ai-skills-for-claude-code-copilot-cursor-etc)
+    - [🤖 Use as a Claude Code Agent](#-use-as-a-claude-code-agent)
   - [Initial Setup: Secrets in the Default Branch](#initial-setup-secrets-in-the-default-branch)
     - [First-Time Setup Flow](#first-time-setup-flow)
     - [Why This Matters](#why-this-matters)
@@ -22,7 +23,7 @@ A command-line tool for managing git worktrees, built with Deno.
     - [Example Configuration](#example-configuration)
     - [Configuration Options](#configuration-options)
   - [Commands](#commands)
-    - [checkout (add, co)](#checkout)
+    - [checkout](#checkout)
       - [Arguments](#arguments)
       - [Options](#options)
       - [Examples](#examples)
@@ -33,21 +34,22 @@ A command-line tool for managing git worktrees, built with Deno.
       - [Examples](#examples-1)
       - [How It Works](#how-it-works)
     - [pr](#pr)
-      - [Arguments](#arguments-3)
+      - [Arguments](#arguments-2)
       - [Options](#options-1)
-      - [Examples](#examples-3)
+      - [Examples](#examples-2)
       - [Requirements](#requirements)
-      - [How It Works](#how-it-works-2)
+      - [How It Works](#how-it-works-1)
     - [update](#update)
       - [Options](#options-2)
-      - [Examples](#examples-4)
-      - [How It Works](#how-it-works-3)
+      - [Examples](#examples-3)
+      - [How It Works](#how-it-works-2)
     - [install-shell](#install-shell)
       - [Options](#options-3)
-      - [Examples](#examples-5)
+      - [Examples](#examples-4)
+      - [Migrating from File-Based Integration](#migrating-from-file-based-integration)
     - [root](#root)
-      - [Examples](#examples-6)
-      - [How It Works](#how-it-works-4)
+      - [Examples](#examples-5)
+      - [How It Works](#how-it-works-3)
     - [init](#init)
       - [Options](#options-4)
       - [Clone Examples](#clone-examples)
@@ -57,17 +59,17 @@ A command-line tool for managing git worktrees, built with Deno.
       - [When to Use](#when-to-use)
     - [show-init](#show-init)
       - [Options](#options-5)
-      - [Examples](#examples-7)
+      - [Examples](#examples-6)
       - [Output Example](#output-example)
       - [When to Use](#when-to-use-1)
     - [sync](#sync)
-      - [Arguments](#arguments-4)
+      - [Arguments](#arguments-3)
       - [Options](#options-6)
-      - [Examples](#examples-8)
+      - [Examples](#examples-7)
     - [clean](#clean)
       - [Options](#options-7)
-      - [Examples](#examples-9)
-      - [How It Works](#how-it-works-5)
+      - [Examples](#examples-8)
+      - [How It Works](#how-it-works-4)
     - [Git Worktree Proxy Commands](#git-worktree-proxy-commands)
       - [list (ls)](#list-ls)
       - [remove (rm)](#remove-rm)
@@ -83,13 +85,14 @@ A command-line tool for managing git worktrees, built with Deno.
       - [Shell Alias Method (Recommended)](#shell-alias-method-recommended)
     - [Available Scripts](#available-scripts)
     - [Publishing](#publishing)
-      - [Automated Release (Recommended)](#automated-release-recommended)
-      - [Manual Publishing](#manual-publishing)
+      - [How It Works](#how-it-works-5)
+      - [Conventional Commits](#conventional-commits)
+      - [Testing Releases](#testing-releases)
+      - [Manual Publishing (Fallback)](#manual-publishing-fallback)
       - [Publishing to JSR (Optional)](#publishing-to-jsr-optional)
-      - [Version Management](#version-management)
     - [Project Structure](#project-structure)
     - [Adding New Commands](#adding-new-commands)
-      - [Custom Commands (like `add`, `copy`)](#custom-commands-like-add-copy)
+      - [Custom Commands (like `checkout`, `sync`)](#custom-commands-like-checkout-sync)
       - [Git Proxy Commands (like `list`, `remove`)](#git-proxy-commands-like-list-remove)
   - [License](#license)
 
@@ -135,19 +138,14 @@ gw checkout main
 Enhance your AI agent with gw-tools knowledge using [skills.sh](https://skills.sh):
 
 ```bash
-npx skills add https://github.com/mthines/gw-tools --skill @gw-git-worktree-workflows @gw-config-management @gw-autonomous-workflow # installs all skills
+npx skills add https://github.com/mthines/gw-tools --skill
 ```
 
-```bash
-# Autonomous feature development workflow
-npx skills add https://github.com/mthines/gw-tools --skill @gw-autonomous-workflow
+Available skills:
 
-# Master Git worktrees and gw workflows
-npx skills add https://github.com/mthines/gw-tools --skill @gw-git-worktree-workflows
-
-# Configure gw for your project type (Next.js, monorepos, etc.)
-npx skills add https://github.com/mthines/gw-tools --skill @gw-config-management
-```
+- **autonomous-workflow** - Autonomous feature development from requirements to PR
+- **git-worktree-workflows** - Master Git worktrees and gw workflows
+- **gw-config-management** - Configure gw for your project type (Next.js, monorepos, etc.)
 
 Once installed, your AI agent can:
 
@@ -159,6 +157,29 @@ Once installed, your AI agent can:
 
 📖 **Skill documentation:** [skills/README.md](../../skills/README.md)
 
+### 🤖 Use as a Claude Code Agent
+
+Want Claude Code to autonomously implement features end-to-end? Install the autonomous workflow agent:
+
+```bash
+# One-liner install (global)
+mkdir -p ~/.claude/agents && \
+  curl -fsSL https://raw.githubusercontent.com/mthines/gw-tools/main/packages/autonomous-workflow-agent/agents/autonomous-workflow.md \
+  -o ~/.claude/agents/autonomous-workflow.md
+
+# Or manually: copy the file from packages/autonomous-workflow-agent/agents/autonomous-workflow.md
+# to ~/.claude/agents/ (global) or .claude/agents/ (per-project)
+```
+
+Once installed, Claude will automatically use this agent when you ask it to implement features, and it will:
+
+- Create isolated worktrees for each task
+- Plan and implement incrementally
+- Run tests and iterate until passing
+- Create draft PRs with full context
+
+📦 **Building custom agents?** See [@gw-tools/autonomous-workflow-agent](https://www.npmjs.com/package/@gw-tools/autonomous-workflow-agent) for SDK integration.
+
 ## Initial Setup: Secrets in the Default Branch
 
 **Important:** Before using `gw checkout` 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.
@@ -1529,125 +1550,83 @@ nx run gw-tool:test
 
 ### Publishing
 
-This tool uses **automated semantic versioning** based on conventional commits. The version is automatically determined from your commit messages.
+Releases are **fully automated** via CI. No manual release commands are needed.
+
+#### How It Works
+
+**Beta Releases (on Pull Requests):**
 
-#### Automated Release (Recommended)
+When you open a non-draft PR with changes to `packages/gw-tool/src/`:
 
-The simplest way to publish is using the automated release process:
+1. CI runs tests
+2. If tests pass, a beta version is automatically created (e.g., `0.29.0-beta.27.1`)
+3. The beta is published to npm with the `beta` tag and Homebrew as `gw-beta`
+4. A comment is added to the PR with installation instructions
 
 ```bash
-# Make sure you're on main/master branch with all changes pushed
-nx run gw-tool:release
+# Install beta version
+npm install @gw-tools/gw@beta
+brew install mthines/gw-tools/gw-beta
 ```
 
-This single command will:
+**Stable Releases (on Merge to Main):**
+
+When a PR is merged to `main` with changes to `packages/gw-tool/src/`:
 
-1. Analyze your commits since the last release
-2. Automatically determine version bump (major/minor/patch)
-3. Update npm/package.json with the new version
-4. Create a git commit and tag
-5. Push to GitHub
-6. Build binaries for all platforms
-7. Create a GitHub release with binaries attached
-8. Publish to npm
+1. CI automatically determines the version bump from conventional commits
+2. Updates `package.json`, creates a git tag, and pushes
+3. Builds binaries for all platforms
+4. Creates a GitHub release with binaries attached
+5. Publishes to npm and updates Homebrew tap
 
-**Conventional Commit Format:**
+#### Conventional Commits
 
 Use these commit prefixes to control versioning:
 
-- `feat:` - New feature (bumps **MINOR** version: 1.0.0 → 1.1.0)
-- `fix:` - Bug fix (bumps **PATCH** version: 1.0.0 → 1.0.1)
-- `BREAKING CHANGE:` or `feat!:` or `fix!:` - Breaking change (bumps **MAJOR** version: 1.0.0 → 2.0.0)
-- `chore:`, `docs:`, `style:`, `refactor:`, `test:` - No version bump
+| Prefix                         | Version Bump          | Example                        |
+| ------------------------------ | --------------------- | ------------------------------ |
+| `feat:`                        | Minor (1.0.0 → 1.1.0) | `feat: add dry-run mode`       |
+| `fix:`                         | Patch (1.0.0 → 1.0.1) | `fix: correct path resolution` |
+| `feat!:` or `BREAKING CHANGE:` | Major (1.0.0 → 2.0.0) | `feat!: redesign config`       |
+| `chore:`, `docs:`, `refactor:` | No bump               | `docs: update README`          |
 
-**Examples:**
+#### Testing Releases
+
+To test the release workflow without publishing:
 
 ```bash
-git commit -m "feat: add dry-run mode"           # 1.0.0 → 1.1.0
-git commit -m "fix: correct path resolution"     # 1.0.0 → 1.0.1
-git commit -m "feat!: redesign config structure" # 1.0.0 → 2.0.0
-git commit -m "docs: update README"              # no version bump
+# Trigger a dry-run release via GitHub Actions
+gh workflow run ci.yml -f test_release=true -f version=0.0.0-test
 ```
 
-#### Manual Publishing
+#### Manual Publishing (Fallback)
 
-If you prefer manual control or need to debug the release process:
+If CI fails or you need manual control:
 
 ```bash
-# 1. Update version
-cd packages/gw-tool/npm
-npm version 1.0.0
-cd ../../..
-
-# 2. Commit and push
-git add packages/gw-tool/npm/package.json
-git commit -m "chore: bump version to 1.0.0"
-git push
-
-# 3. Build binaries
+# 1. Build binaries
 nx run gw-tool:compile-all
 nx run gw-tool:npm-pack
 
-# 4. Create GitHub release
+# 2. Create GitHub release
 gh release create "v1.0.0" \
   --title "v1.0.0" \
   --notes "Release notes" \
   dist/packages/gw-tool/binaries/*
 
-# 5. Publish to npm
+# 3. Publish to npm
 cd dist/packages/gw-tool/npm
 npm publish --access public
 ```
 
 #### Publishing to JSR (Optional)
 
-For users who prefer Deno's native package manager.
-
-1. **Add JSR configuration to `deno.json`:**
-
-   ```json
-   {
-     "name": "@your-scope/gw",
-     "version": "1.0.0",
-     "exports": "./src/main.ts"
-   }
-   ```
-
-2. **Publish:**
-   ```bash
-   nx run gw-tool:publish-jsr
-   ```
-
-#### Version Management
-
-**Automated Approach (Recommended):**
-
-Use conventional commits and let the system determine the version:
+For users who prefer Deno's native package manager:
 
 ```bash
-# Make changes
-git add .
-git commit -m "feat: add new awesome feature"
-
-# When ready to release
-nx run gw-tool:release
+nx run gw-tool:publish-jsr
 ```
 
-The version is automatically determined from your commits:
-
-- `feat:` → minor version bump (1.0.0 → 1.1.0)
-- `fix:` → patch version bump (1.0.0 → 1.0.1)
-- `feat!:` or `BREAKING CHANGE:` → major version bump (1.0.0 → 2.0.0)
-
-**Manual Approach:**
-
-If you prefer manual control:
-
-1. Update `packages/gw-tool/npm/package.json` version
-2. Update `packages/gw-tool/deno.json` version (if using JSR)
-3. Commit and push changes
-4. Build, create release, and publish manually
-
 ### Project Structure
 
 ```

package/package.json

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