wt-manager 1.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Durika
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,343 @@
+# Git Worktree Manager
+
+The dashboard Git forgot to include.
+
+## The Problem
+
+Git worktrees let you work on multiple branches simultaneously—but managing them? That's where the fun ends.
+
+- **"Which folder was that again?"** - You have 5 worktree directories and zero memory of which one has `feature/auth`
+- **The GitHub tab dance** - Constantly switching to check if that PR got merged yet, or if it's still sitting in review purgatory
+- **Stale worktree graveyard** - Merged PRs pile up as forgotten worktrees, each one silently judging your organizational skills
+- **Three tools, zero coordination** - Git knows your worktrees. GitHub knows your PRs. Your filesystem knows your folders. They don't talk to each other.
+
+## The Solution
+
+`wt` gives you the dashboard Git forgot to include.
+
+![wt list output](./wt-list.png)
+
+The `wt list` command shows you everything:
+- All your worktrees with their PR status (open/draft/merged/closed)
+- Which branches are ahead/behind
+- CI check status (passing/failing)
+- Uncommitted changes warnings
+
+And when you're done? `wt clean` finds all merged/closed PRs and removes their worktrees and branches in one go. It even asks nicely before deleting anything.
+
+## Quick Start
+
+**Requirements:** Node.js 22+, Git, and [GitHub CLI](https://cli.github.com/) (`gh auth login`)
+
+```bash
+# Install globally
+npm install -g .
+
+# Create a new worktree
+wt feature/my-feature
+
+# See all worktrees with PR status
+wt list
+
+# Clean up merged/closed worktrees
+wt clean
+```
+
+### Shell Integration
+
+For the full workflow (create worktree → cd into it → open IDE → start Claude):
+
+```bash
+# Add to ~/.zshrc
+eval "$(wt init)"
+
+# To initialize a new worktree and branch call
+wt feature/my-feature
+# To navigate to it, open WebStorm, and start Claude, run:
+wtl ../repo-worktrees/feature-my-feature
+```
+
+## Commands
+
+### `wt <branch-name> [base-branch]`
+### `wt new <branch-name> [base-branch]`
+
+Create a new worktree for a new branch. Worktrees are created in `../<repo>-worktrees/` directory.
+
+```bash
+# Create worktree from default branch (shorthand)
+wt feature/new-feature
+
+# Create worktree from default branch (explicit)
+wt new feature/new-feature
+
+# Create worktree from specific base branch
+wt new feature/new-feature develop
+```
+
+**Arguments:**
+- `<branch-name>` - Name of the new branch to create
+- `[base-branch]` - Base branch to create from (default: auto-detected from origin/HEAD)
+
+**Behavior:**
+- Automatically creates the worktree directory structure
+- Converts slashes in branch names to dashes for directory names (e.g., `feature/foo` → `feature-foo`)
+- Shows spinner during creation
+- Fails if branch already exists locally
+- Symlinks `.env` file from main worktree if present
+- Copies `.claude/settings.local.json` from main worktree if present
+- Copies WebStorm `.idea` settings from main worktree (run configurations, code styles, inspection profiles, scopes, and project files)
+- Copies worktree path to clipboard for easy navigation
+
+### `wt list`
+
+List all worktrees with their status, PR information, and branch details.
+
+```bash
+# List all worktrees with status
+wt list
+
+# JSON output format
+wt list --json
+```
+
+**Options:**
+- `--json` - Output in JSON format (disables spinner)
+
+**Output includes:**
+- Worktree directory name
+- PR status (open/draft/merged/closed/no-pr)
+- Branch ahead/behind counts relative to default branch
+- Uncommitted changes indicator
+- CI check status (passing/failing)
+- Current worktree indicator
+- PR URL (if available)
+- Summary statistics
+
+**Example output:**
+```
+Worktrees for my-repo:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+feature-auth                             open (↑3 ↓0)
+  Branch: feature/auth
+  PR: https://github.com/owner/repo/pull/123
+
+bugfix-login                             merged (↑0 ↓2)
+  Branch: bugfix/login
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Summary: 2 worktrees (1 open, 1 merged)
+💡 Run 'wt clean' to remove 1 merged/closed worktree(s)
+```
+
+### `wt clean`
+
+Remove worktrees for branches with merged or closed PRs, abandoned folders, and orphan worktrees. Uses interactive checkbox selection.
+
+```bash
+# Clean up merged/closed worktrees (interactive)
+wt clean
+
+# Dry run to see what would be removed
+wt clean --dry-run
+
+# Skip interactive selection (select all)
+wt clean --force
+```
+
+**Options:**
+- `-d, --dry-run` - Show what would be removed without actually removing
+- `-f, --force` - Skip interactive selection (removes all cleanable items)
+
+**What it detects:**
+- **Merged/Closed worktrees** - Worktrees with merged or closed PRs
+- **Abandoned folders** - Directories in worktrees folder without `.git` (leftover from manual deletions)
+- **Orphan worktrees** - Directories with `.git` file pointing to non-existent gitdir
+
+**Safety features:**
+- Shows spinner while checking PR status
+- Automatically skips worktrees with uncommitted changes (warns user)
+- Skips the current worktree
+- Interactive checkbox selection to choose what to remove
+- Automatically deletes local branch when removing worktree
+- Only processes worktrees in `<repo>-worktrees/` directory
+
+**Example flow:**
+```
+Scanning worktrees...
+Checking PR status...
+Scanning for abandoned folders...
+
+⚠ Skipped (uncommitted changes):
+  bugfix-draft (bugfix/draft)
+
+? Select worktrees to remove:
+❯ ◯ feature-old (MERGED)
+  ◯ bugfix-done (CLOSED)
+  ◯ leftover-dir (abandoned)
+  ◯ broken-wt (orphan)
+
+Removing feature-old...
+✓ Removed: feature-old (branch deleted)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✓ Cleaned up 1 worktree(s)!
+Run 'wt list' to see remaining worktrees.
+```
+
+### `wt remove <name>`
+
+Remove a specific worktree by name. Interactive with safety prompts for uncommitted changes and unpushed commits.
+
+```bash
+# Remove by branch name
+wt remove feature/my-feature
+
+# Remove by directory name
+wt remove feature-my-feature
+
+# Keep the local branch (only remove worktree)
+wt remove feature/my-feature --keep-branch
+
+# Force removal (skip all prompts)
+wt remove feature/my-feature --force
+```
+
+**Arguments:**
+- `<name>` - Worktree name (matches branch name or directory name)
+
+**Options:**
+- `--keep-branch` - Keep the local branch after removing the worktree
+- `-f, --force` - Force removal even with uncommitted changes or unpushed commits
+
+**Safety features:**
+- Shows uncommitted changes before removal
+- Option to view diff before discarding changes
+- Warns about unpushed commits before branch deletion
+- Warns about branches with no remote tracking
+- Interactive prompts to abort, keep branch, or proceed
+
+**Example flow:**
+```
+Worktree: feature-my-feature
+  Path: /path/to/repo-worktrees/feature-my-feature
+  Branch: feature/my-feature
+
+⚠ Uncommitted changes detected:
+
+Modified:
+  src/file.ts
+
+? What would you like to do?
+❯ Show diff
+  Discard changes and remove
+  Abort
+
+✓ Removed worktree: feature-my-feature
+✓ Deleted branch: feature/my-feature
+
+Run 'wt list' to see remaining worktrees
+```
+
+### `wt init`
+
+Output shell function for `~/.zshrc` integration. Creates a `wtl` command that automates the full workflow.
+
+```bash
+# Add to ~/.zshrc:
+eval "$(wt init)"
+```
+
+**The `wtl` function:**
+1. Creates a new worktree (`wt new`)
+2. Changes to the worktree directory
+3. Opens WebStorm
+4. Starts Claude
+
+```bash
+# Usage:
+wtl feature/my-feature
+```
+
+## GitHub Integration
+
+This tool integrates with GitHub to provide rich PR information:
+
+- **PR Status** - Displays open/draft/merged/closed state
+- **PR URLs** - Direct links to pull requests
+- **CI Checks** - Shows if checks are passing or failing
+- **Smart Cleanup** - Identifies branches safe to remove based on PR state
+- **Draft Detection** - Shows when PRs are in draft state
+
+### Authentication
+
+Uses existing GitHub CLI (`gh`) authentication. Make sure you're logged in:
+
+```bash
+gh auth login
+```
+
+The tool will show helpful error messages if:
+- `gh` CLI is not installed
+- You're not authenticated
+- The repository doesn't have a GitHub remote
+
+### Without GitHub
+
+The tool works without GitHub integration, but with limited functionality:
+- `wt list` will show "no-pr" status for all worktrees
+- `wt clean` requires GitHub CLI and won't work without it
+
+## Workflow Example
+
+Here's a typical workflow using these tools:
+
+```bash
+# Create a new worktree for a feature
+wt feature/add-auth
+
+# Navigate to the worktree
+cd ../my-repo-worktrees/feature-add-auth
+
+# Work on your feature...
+git add .
+git commit -m "Add authentication"
+git push -u origin feature/add-auth
+
+# Create PR via gh CLI
+gh pr create --title "Add authentication" --body "Implements user auth"
+
+# Check status of all worktrees
+wt list
+# Shows: feature-add-auth (open)
+
+# After PR is merged, clean up
+wt clean
+# Removes merged worktree and deletes branch
+```
+
+## Development
+
+### Build
+
+```bash
+npm run build
+```
+
+### Watch Mode
+
+```bash
+npm run dev
+```
+
+### Linting
+
+```bash
+npm run lint
+npm run format
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { newCommand } from './commands/new.js';
+import { listCommand } from './commands/list.js';
+import { cleanCommand } from './commands/clean.js';
+import { removeCommand } from './commands/remove.js';
+import { initCommand } from './commands/init.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const program = new Command();
+program
+    .name('wt')
+    .description('Git Worktree Manager - Manage git worktrees with GitHub integration')
+    .version(pkg.version, '-v, --version', 'output the version number');
+program.addCommand(newCommand());
+program.addCommand(listCommand());
+program.addCommand(cleanCommand());
+program.addCommand(removeCommand());
+program.addCommand(initCommand());
+const args = process.argv.slice(2);
+if (args.length > 0 && !['new', 'list', 'clean', 'remove', 'init', '-h', '--help', '-v', '--version'].includes(args[0])) {
+    process.argv.splice(2, 0, 'new');
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAA;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,qEAAqE,CAAC;KAClF,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAA;AAGrE,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAA;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAA;AACjC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAA;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAA;AACnC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAA;AAGjC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAExH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AAClC,CAAC;AAED,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/commands/clean.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function cleanCommand(): Command;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsJnC,wBAAgB,YAAY,YAiS3B"}