worktree-launcher 1.0.0 → 1.0.2

package/README.md

@@ -1,65 +1,83 @@
-# worktree-launcher (wt)
+# worktree-launcher
 
-CLI tool to streamline git worktrees with AI coding assistants (Claude Code / Codex).
+A CLI tool for managing git worktrees with AI coding assistants.
 
-## Installation
+## The Problem
+
+When working on multiple features or reviewing PRs, developers often need isolated environments. Git worktrees solve this by allowing multiple working directories from a single repository, but the workflow is clunky:
 
 ```bash
-npm install -g worktree-launcher
+# The manual way
+git worktree add ../myproject-feature-auth feature-auth
+cp .env ../myproject-feature-auth/.env
+cp .env.local ../myproject-feature-auth/.env.local
+cd ../myproject-feature-auth
+npm install
+claude  # or codex
 ```
 
-Or for local development:
+This gets tedious fast. Tools like Conductor exist to manage this complexity, but they add overhead for simple use cases.
+
+## The Solution
+
+`wt` streamlines the entire workflow into a single command:
 
 ```bash
-git clone <repo>
-cd worktree-launcher
-npm install
-npm run build
-npm link
+wt new feature-auth
+```
+
+This creates the worktree, copies your environment files, and launches your AI coding assistant in the new directory.
+
+## Installation
+
+```bash
+npm install -g worktree-launcher
 ```
 
+Requires Node.js 18+ and git.
+
 ## Commands
 
-### `wt new <branch-name>`
+### wt new
 
-Create a new worktree and launch your AI assistant.
+Create a new worktree and optionally launch an AI assistant.
 
 ```bash
-wt new feature-auth
+wt new <branch-name> [options]
 ```
 
-This will:
-1. Create a new branch (if it doesn't exist)
-2. Create a worktree at `../<repo-name>-<branch-name>/`
-3. Copy all `.env*` files from the main repo
-4. Show an interactive selector to choose Claude Code or Codex
-5. Launch the selected AI assistant in the new worktree
-
-**Options:**
+Options:
 - `-i, --install` - Run package manager install after creating worktree
 - `-s, --skip-launch` - Create worktree without launching AI assistant
 
-**Examples:**
+Examples:
+
 ```bash
-wt new feature-auth              # Create and launch AI
-wt new feature-auth --install    # Also run npm/yarn/pnpm install
-wt new feature-auth --skip-launch # Just create the worktree
+# Create worktree and launch AI selector
+wt new feature-auth
+
+# Create worktree and run npm/yarn/pnpm install
+wt new feature-auth --install
+
+# Just create the worktree
+wt new feature-auth --skip-launch
 ```
 
-### `wt list` (or `wt ls`)
+The worktree is created at `../<repo-name>-<branch-name>/`. For example, if you run `wt new feature-auth` in `/code/myproject`, the worktree is created at `/code/myproject-feature-auth`.
+
+### wt list
 
 List all worktrees for the current repository.
 
 ```bash
 wt list
+# or
+wt ls
 ```
 
-Shows:
-- Worktree paths
-- Branch names
-- Status (active, merged, local only, detached)
+Output shows path, branch, and status (active, merged, local only).
 
-### `wt clean`
+### wt clean
 
 Interactively remove worktrees for merged or deleted branches.
 
@@ -67,37 +85,48 @@ Interactively remove worktrees for merged or deleted branches.
 wt clean
 ```
 
-This will:
-1. Find worktrees where the branch was merged or deleted
-2. Show an interactive checkbox to select which to remove
-3. Remove selected worktrees
+This finds stale worktrees, shows an interactive selection, and removes the ones you choose.
 
-### `wt remove <name>` (or `wt rm`)
+### wt remove
 
 Remove a specific worktree.
 
 ```bash
-wt remove feature-auth
-wt rm feature-auth --force
+wt remove <name> [options]
+# or
+wt rm <name>
 ```
 
-**Options:**
+Options:
 - `-f, --force` - Force removal even with uncommitted changes
 
-## Worktree Location
+## Workflow
 
-Worktrees are created as siblings to your main repository:
+A typical development workflow:
 
+```bash
+# 1. Start in your main repository
+cd ~/code/myproject
+
+# 2. Create a worktree for a new feature
+wt new feature-user-auth
+# Select Claude Code or Codex from the prompt
+# AI assistant launches in the new worktree
+
+# 3. Work on the feature, commit, push, create PR
+
+# 4. Back in main repo, check your worktrees
+wt list
+
+# 5. After PR is merged, clean up
+wt clean
+# Select merged branches to remove
 ```
-/Users/you/code/
-├── myproject/               # Main repo
-├── myproject-feature-auth/  # Worktree for feature-auth branch
-└── myproject-fix-bug/       # Worktree for fix-bug branch
-```
 
-## Env Files
+## Environment Files
+
+The following files are automatically copied to new worktrees:
 
-The following env files are automatically copied to new worktrees:
 - `.env`
 - `.env.local`
 - `.env.development`
@@ -106,14 +135,24 @@ The following env files are automatically copied to new worktrees:
 - `.env.test.local`
 - `.env.production`
 - `.env.production.local`
+- Any other `.env.*` files
+
+Template files (`.env.example`, `.env.sample`, `.env.template`) are excluded.
+
+## AI Assistants
+
+Currently supports:
+
+- Claude Code
+- Codex
 
-Template files (`.env.example`, `.env.sample`) are not copied.
+The tool checks if your selected assistant is installed before launching. If not found, the worktree is still created and you can launch manually.
 
-## Requirements
+## Security
 
-- Node.js 18+
-- Git
-- Claude Code or Codex CLI installed and in PATH
+Branch names are validated to prevent:
+- Path traversal attacks (`..` sequences)
+- Git flag injection (names starting with `-`)
 
 ## License
 

package/dist/index.js

@@ -175,13 +175,11 @@ import path3 from "path";
 import { constants } from "fs";
 function launchAITool(options) {
   const { cwd, tool } = options;
-  const child = spawn(tool, [], {
+  spawn(tool, [], {
     cwd,
     stdio: "inherit",
-    // Detach so the CLI can exit
-    detached: true
+    shell: true
   });
-  child.unref();
 }
 async function isToolAvailable(tool) {
   return new Promise((resolve) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "worktree-launcher",
-  "version": "1.0.0",
-  "description": "CLI tool to streamline git worktrees with AI coding assistants",
+  "version": "1.0.2",
+  "description": "CLI tool for managing git worktrees with AI coding assistants",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
@@ -11,18 +11,26 @@
     "build": "tsup src/index.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts --format esm --watch",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src/",
     "prepublishOnly": "npm run build"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mertdeveci5/worktree-launcher.git"
+  },
+  "homepage": "https://github.com/mertdeveci5/worktree-launcher#readme",
+  "bugs": {
+    "url": "https://github.com/mertdeveci5/worktree-launcher/issues"
+  },
   "keywords": [
     "git",
     "worktree",
     "cli",
     "claude",
     "codex",
-    "ai"
+    "ai",
+    "developer-tools"
   ],
-  "author": "",
+  "author": "mertdeveci5",
   "license": "MIT",
   "dependencies": {
     "chalk": "^5.3.0",