@hytfjwr/claude-worktree 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hytfjwr
+
+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,233 @@
+# claude-worktree
+
+[![npm version](https://img.shields.io/npm/v/@hytfjwr/claude-worktree.svg)](https://www.npmjs.com/package/@hytfjwr/claude-worktree)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A CLI tool for parallel development using WezTerm + git worktree + Claude Code. It creates a git worktree and launches Claude Code. With the `-pane` option, it opens in a new WezTerm pane for parallel development.
+
+## Requirements
+
+- [Node.js](https://nodejs.org/) (v22+)
+- [Git](https://git-scm.com/)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+- [WezTerm](https://wezfurlong.org/wezterm/) (optional, required only for `-pane`)
+
+## Installation
+
+```bash
+npm install -g @hytfjwr/claude-worktree
+```
+
+Or run directly with npx:
+
+```bash
+npx @hytfjwr/claude-worktree feature/auth 'Implement authentication feature'
+```
+
+## Quick Start
+
+```bash
+# Create a worktree and start Claude Code
+claude-worktree feature/auth 'Implement authentication feature'
+
+# Open in a new WezTerm pane for parallel development
+claude-worktree feature/auth 'Implement authentication feature' -pane
+```
+
+## Usage
+
+### Create Command
+
+```bash
+claude-worktree <branch-name> <prompt>
+claude-worktree <branch-name> -plan <file-path>
+```
+
+### List Command
+
+```bash
+claude-worktree list [options]
+```
+
+### Clean Command
+
+```bash
+claude-worktree clean [options]
+```
+
+### Help
+
+```bash
+claude-worktree -h
+claude-worktree -help
+```
+
+### Options
+
+- `-p, -pane` - Open in a new WezTerm pane (default: run in current terminal)
+- `-plan <file>` - Read prompt from a file (cannot be used with inline prompt)
+- `-base <branch>` - Base branch for worktree (default: current branch)
+- `-danger` - Skip workspace warning (uses --dangerously-skip-permissions)
+- `-merge` - Auto-merge into base branch and cleanup after task completion
+- `-draft` - Auto-create Draft PR after task completion (cannot be used with -merge)
+- `-v, -verbose` - Show hook execution logs
+- `-h, -help` - Show help
+
+### List Options
+
+- `-j, -json` - Output as JSON
+- `-s, -status` - Show Claude session status (Running/Done)
+- `-v, -verbose` - Show full paths and details
+
+### Clean Options
+
+- `-f, -force` - Skip confirmation prompt
+- `-a, -all` - Show all worktrees for manual selection
+- `-n, -dry-run` - Preview targets without deleting
+- `-v, -verbose` - Show hook execution logs
+
+### Examples
+
+```bash
+# Create a worktree and start Claude Code in current terminal
+claude-worktree feature/auth 'Implement authentication feature'
+
+# Open in a new WezTerm pane
+claude-worktree feature/auth 'Implement authentication feature' -pane
+
+# Short form
+claude-worktree fix/bug-123 'Fix login bug' -p
+
+# Read prompt from a plan file
+claude-worktree feature/api -plan ./plan.md
+
+# Create worktree from specific base branch
+claude-worktree feature/auth 'Implement authentication feature' -base develop
+
+# Skip workspace warning
+claude-worktree feature/auth 'Implement authentication feature' -danger
+
+# Auto-merge into base branch after task completion
+claude-worktree feature/auth 'Implement authentication feature' -merge
+
+# Auto-create Draft PR after task completion
+claude-worktree feature/auth 'Implement authentication feature' -draft
+
+# Draft PR with specific base branch
+claude-worktree feature/auth 'Implement authentication feature' -draft -base main
+
+# List worktrees with status
+claude-worktree list
+
+# Show Claude session status (Running/Done)
+claude-worktree list -status
+
+# List worktrees as JSON
+claude-worktree list -json
+
+# Clean up unnecessary worktrees
+claude-worktree clean
+
+# Preview worktrees to be deleted
+claude-worktree clean -dry-run
+
+# Select from all worktrees manually
+claude-worktree clean -all
+```
+
+### JSON Output Schema
+
+When using `claude-worktree list -json`, the output follows this schema:
+
+```json
+{
+  "worktrees": [
+    {
+      "path": "/absolute/path/to/worktree",
+      "branch": "feature/auth",
+      "isMain": false,
+      "isLocked": false,
+      "isDirty": false,
+      "status": "Active",
+      "commit": {
+        "hash": "abc1234",
+        "message": "Commit message",
+        "date": "2025-01-15T10:00:00.000Z"
+      },
+      "aheadBehind": { "ahead": 2, "behind": 0 },
+      "session": {
+        "status": "running",
+        "elapsedMs": 900000,
+        "mode": "pane",
+        "paneId": 3
+      }
+    }
+  ]
+}
+```
+
+| Field | Type | Description |
+|---|---|---|
+| `path` | `string` | Absolute path to the worktree directory |
+| `branch` | `string \| null` | Branch name, or `null` for detached HEAD |
+| `isMain` | `boolean` | Whether this is the main worktree |
+| `isLocked` | `boolean` | Whether the worktree is locked |
+| `isDirty` | `boolean` | Whether the worktree has uncommitted changes |
+| `status` | `string` | One of: `"Main"`, `"Locked"`, `"Merged"`, `"Dirty"`, `"Active"` |
+| `commit` | `object \| null` | Latest commit info (`hash`, `message`, `date`) |
+| `aheadBehind` | `object \| null` | `{ ahead: number, behind: number }` relative to main branch |
+| `session` | `object \| undefined` | Claude session info (only with `-status` flag) |
+| `session.status` | `string` | `"running"` or `"done"` |
+| `session.elapsedMs` | `number` | Milliseconds since session started |
+| `session.mode` | `string` | `"pane"` or `"terminal"` |
+| `session.paneId` | `number \| undefined` | WezTerm pane ID (pane mode only) |
+
+## Hook Configuration
+
+You can define project-specific hooks in `.claude-worktree.json` at the repository root:
+
+```json
+{
+  "maxWorktrees": 5,
+  "hookTimeout": 600,
+  "postCreate": "cd {path} && docker-compose -p app-{slot} up -d",
+  "postCreateTimeout": 300,
+  "preClean": "cd {path} && docker-compose down",
+  "preCleanTimeout": 120,
+  "postClean": "docker volume rm app-{path}-data || true",
+  "postCleanTimeout": 60
+}
+```
+
+### Worktree Limit
+
+- `maxWorktrees` — Maximum number of concurrent worktrees (excludes main). If set, blocks creation when the limit is reached.
+
+### Template Variables
+
+- `{path}` — worktree path
+- `{slot}` — auto-assigned slot number (1-9) based on port availability (8881-8889). Slot assignments are persisted to `~/.cache/claude-worktree/slots.json` so that `preClean`/`postClean` hooks can reference the same slot that was assigned during `postCreate`.
+
+### Hooks
+
+- **postCreate** — Runs after worktree creation (e.g., start Docker containers). If the hook fails, the worktree is automatically rolled back.
+- **preClean** — Runs before worktree deletion (e.g., stop Docker containers). If the hook fails, deletion continues with a warning.
+- **postClean** — Runs after worktree and branch deletion (e.g., Docker volume removal, DNS cleanup). If the hook fails, the operation continues with a warning.
+
+### Timeout
+
+- `hookTimeout` — Global default timeout in seconds (default: `600`)
+- `postCreateTimeout` — Override timeout for postCreate hook
+- `preCleanTimeout` — Override timeout for preClean hook
+- `postCleanTimeout` — Override timeout for postClean hook
+
+Priority: hook-specific value > `hookTimeout` > default (600s)
+
+### Environment Variables
+
+- `CLAUDE_WORKTREE_CACHE_DIR` — Override the slot cache directory (default: `~/.cache/claude-worktree`)
+- `NO_COLOR` — Disable colored output ([no-color.org](https://no-color.org/)). Colors are also automatically disabled when stdout is not a TTY (e.g., piped output).
+
+## License
+
+[MIT](LICENSE)

package/dist/bin/claude-worktree.d.ts

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

package/dist/bin/claude-worktree.d.ts.map

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

package/dist/bin/claude-worktree.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { parseArgs, run } from "../src/cli.js";
+async function main() {
+    try {
+        const command = parseArgs(process.argv.slice(2));
+        await run(command);
+    }
+    catch (error) {
+        console.error("Error:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=claude-worktree.js.map

package/dist/bin/claude-worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-worktree.js","sourceRoot":"","sources":["../../bin/claude-worktree.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAE/C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,17 @@
+import type { CleanArgs, Command, CreateArgs, ListArgs } from "./types.ts";
+export declare function showHelp(): void;
+export declare function showCreateHelp(): void;
+export declare function showListHelp(): void;
+export declare function showCleanHelp(): void;
+/**
+ * Validate a branch name against git's naming rules.
+ * Returns an error message if invalid, or null if valid.
+ * See: https://git-scm.com/docs/git-check-ref-format
+ */
+export declare function validateBranchName(name: string): string | null;
+export declare function parseCreateArgs(args: string[]): CreateArgs;
+export declare function parseCleanArgs(args: string[]): CleanArgs;
+export declare function parseListArgs(args: string[]): ListArgs;
+export declare function parseArgs(args: string[]): Command;
+export declare function run(command: Command): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3E,wBAAgB,QAAQ,IAAI,IAAI,CAoD/B;AAED,wBAAgB,cAAc,IAAI,IAAI,CA+BrC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAoBnC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAqBpC;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4C9D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6E1D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAmBxD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAiBtD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAkDjD;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BzD"}

package/dist/src/cli.js

@@ -0,0 +1,360 @@
+import { executeClean } from "./commands/clean.js";
+import { runCreate } from "./commands/create.js";
+import { executeList } from "./commands/list.js";
+import { executeRunInPane, parseRunInPaneArgs } from "./commands/run-in-pane.js";
+import { extractOptions } from "./options.js";
+export function showHelp() {
+    console.log(`claude-worktree - CLI for parallel development with WezTerm + git worktree + Claude Code
+
+Usage:
+  claude-worktree <branch-name> <prompt>
+  claude-worktree <branch-name> -plan <file-path>
+  claude-worktree list [options]
+  claude-worktree clean [options]
+
+Commands:
+  <branch-name>  Create a new worktree with Claude Code
+  list           List existing worktrees with status
+  clean          Remove unnecessary worktrees
+
+Arguments:
+  <branch-name>  Branch name for the git worktree to create
+  <prompt>       Prompt to pass to Claude Code
+
+Options:
+  -p, -pane       Open in a new WezTerm pane (requires WezTerm; default: run in current terminal)
+  -plan <file>    Read prompt from a plan file (cannot be used with inline prompt)
+  -b, -base <branch>  Specify base branch (default: current branch)
+  -d, -danger     Skip workspace warning (uses --dangerously-skip-permissions)
+  -m, -merge      Auto-merge into base branch and cleanup after task completion
+  -draft          Auto-create Draft PR after task completion (cannot be used with -merge)
+  -v, -verbose    Show hook execution logs
+  -h, -help       Show this help
+
+List options:
+  -j, -json      Output as JSON
+  -s, -status    Show Claude session status (Running/Done)
+  -v, -verbose   Show full paths and details
+
+Clean options:
+  -f, -force     Skip confirmation prompt
+  -a, -all       Show all worktrees for manual selection
+  -n, -dry-run   Preview targets without deleting
+  -v, -verbose   Show hook execution logs
+
+Examples:
+  claude-worktree feature/auth 'Implement authentication feature'
+  claude-worktree feature/auth 'Implement authentication feature' -p
+  claude-worktree fix/bug-123 'Fix login bug' -pane
+  claude-worktree feature/api -plan ./plan.md
+  claude-worktree feature/auth 'Implement authentication feature' -danger
+  claude-worktree feature/auth 'Implement authentication feature' -merge
+  claude-worktree feature/auth 'Implement authentication feature' -draft
+  claude-worktree feature/auth 'Implement authentication feature' -draft -base main
+  claude-worktree list
+  claude-worktree list -json
+  claude-worktree clean
+  claude-worktree clean -dry-run`);
+}
+export function showCreateHelp() {
+    console.log(`claude-worktree <branch-name> - Create a new worktree and launch Claude Code
+
+Creates a git worktree for a new branch, then starts a Claude Code session.
+Optionally opens in a new WezTerm pane for parallel development.
+
+Usage:
+  claude-worktree <branch-name> <prompt>
+  claude-worktree <branch-name> -plan <file-path>
+
+Arguments:
+  <branch-name>  Branch name for the git worktree to create
+  <prompt>       Prompt to pass to Claude Code
+
+Options:
+  -p, -pane            Open in a new WezTerm pane (requires WezTerm; default: run in current terminal)
+  -plan <file>         Read prompt from a plan file (cannot be used with inline prompt)
+  -b, -base <branch>   Specify base branch (default: current branch)
+  -d, -danger          Skip workspace warning (uses --dangerously-skip-permissions)
+  -m, -merge           Auto-merge into base branch and cleanup after task completion
+  -draft               Auto-create Draft PR after task completion (cannot be used with -merge)
+  -v, -verbose         Show hook execution logs
+  -h, -help            Show this help
+
+Examples:
+  claude-worktree feature/auth 'Implement authentication feature'
+  claude-worktree feature/auth 'Implement auth' -pane
+  claude-worktree feature/auth -plan ./plan.md
+  claude-worktree feature/auth 'Implement auth' -base develop
+  claude-worktree feature/auth 'Implement auth' -merge
+  claude-worktree feature/auth 'Implement auth' -draft -base main`);
+}
+export function showListHelp() {
+    console.log(`claude-worktree list - List existing worktrees with status
+
+Displays all git worktrees managed by claude-worktree, including branch info,
+commit details, and optionally Claude session status.
+
+Usage:
+  claude-worktree list [options]
+
+Options:
+  -j, -json      Output as JSON (machine-readable format)
+  -s, -status    Show Claude session status (Running/Done)
+  -v, -verbose   Show full paths and details
+  -h, -help      Show this help
+
+Examples:
+  claude-worktree list
+  claude-worktree list -status
+  claude-worktree list -json
+  claude-worktree list -verbose`);
+}
+export function showCleanHelp() {
+    console.log(`claude-worktree clean - Remove unnecessary worktrees
+
+Identifies worktrees that can be safely removed (merged branches, deleted remote
+branches) and prompts for confirmation before deleting.
+
+Usage:
+  claude-worktree clean [options]
+
+Options:
+  -f, -force     Skip confirmation prompt
+  -a, -all       Show all worktrees for manual selection
+  -n, -dry-run   Preview targets without deleting
+  -v, -verbose   Show hook execution logs
+  -h, -help      Show this help
+
+Examples:
+  claude-worktree clean
+  claude-worktree clean -dry-run
+  claude-worktree clean -force
+  claude-worktree clean -all`);
+}
+const CREATE_USAGE = "claude-worktree <branch-name> <prompt>\n" + "  claude-worktree <branch-name> -plan <file-path>";
+/**
+ * Validate a branch name against git's naming rules.
+ * Returns an error message if invalid, or null if valid.
+ * See: https://git-scm.com/docs/git-check-ref-format
+ */
+export function validateBranchName(name) {
+    if (name.startsWith("-")) {
+        return `Invalid branch name: "${name}". Branch names cannot start with "-".`;
+    }
+    if (name.startsWith(".") || name.endsWith(".")) {
+        return `Invalid branch name: "${name}". Branch names cannot start or end with ".".`;
+    }
+    // Check for path components starting with "." (e.g., feature/.hidden)
+    const components = name.split("/");
+    for (const component of components) {
+        if (component.startsWith(".")) {
+            return `Invalid branch name: "${name}". Path components cannot start with ".".`;
+        }
+    }
+    if (name.endsWith(".lock")) {
+        return `Invalid branch name: "${name}". Branch names cannot end with ".lock".`;
+    }
+    if (name.includes("..")) {
+        return `Invalid branch name: "${name}". Branch names cannot contain "..".`;
+    }
+    if (name.includes("//")) {
+        return `Invalid branch name: "${name}". Branch names cannot contain consecutive slashes.`;
+    }
+    if (name.endsWith("/")) {
+        return `Invalid branch name: "${name}". Branch names cannot end with "/".`;
+    }
+    if (name.includes("@{")) {
+        return `Invalid branch name: "${name}". Branch names cannot contain "@{".`;
+    }
+    if (name === "@") {
+        return `Invalid branch name: "${name}". Branch name cannot be "@".`;
+    }
+    if (name.includes("\\")) {
+        return `Invalid branch name: "${name}". Branch names cannot contain backslashes.`;
+    }
+    // Check for spaces, control characters (~, ^, :, ?, *, [)
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: intentionally matching git-forbidden control chars
+    const invalidCharMatch = name.match(/[\s~^:?*[\x00-\x1f\x7f]/);
+    if (invalidCharMatch) {
+        const char = invalidCharMatch[0];
+        const displayChar = char.trim() === "" ? "whitespace" : `"${char}"`;
+        return `Invalid branch name: "${name}". Branch names cannot contain ${displayChar}.`;
+    }
+    return null;
+}
+export function parseCreateArgs(args) {
+    if (args.length < 1) {
+        throw new Error(`Usage:\n  ${CREATE_USAGE}\n\n` +
+            "Example:\n" +
+            "  claude-worktree feature/auth 'Implement authentication feature'\n" +
+            "  claude-worktree feature/auth -plan ./plan.md");
+    }
+    const branchName = args[0];
+    // Validate branch name
+    const branchError = validateBranchName(branchName);
+    if (branchError) {
+        throw new Error(branchError);
+    }
+    const { booleans, strings, remaining } = extractOptions(args.slice(1), {
+        options: {
+            pane: { type: "boolean", flag: "-pane", alias: "-p" },
+            danger: { type: "boolean", flag: "-danger", alias: "-d" },
+            merge: { type: "boolean", flag: "-merge", alias: "-m" },
+            draft: { type: "boolean", flag: "-draft" },
+            verbose: { type: "boolean", flag: "-verbose", alias: "-v" },
+            baseBranch: { type: "string", flag: "-base", alias: "-b", errorMessage: "-base requires a branch name argument" },
+            planFile: { type: "string", flag: "-plan", errorMessage: "-plan requires a file path argument" },
+        },
+        unknownHandling: "error",
+        ignoredFlags: ["-h", "-help"],
+        unknownErrorPrefix: "Unknown option",
+    });
+    const { pane, danger, merge, draft, verbose } = booleans;
+    const { baseBranch, planFile } = strings;
+    // Check for unknown options
+    const unknownFlag = remaining.find((arg) => arg.startsWith("-"));
+    if (unknownFlag) {
+        throw new Error(`Unknown option: ${unknownFlag}`);
+    }
+    // Mutual exclusivity check for -merge and -draft
+    if (merge && draft) {
+        throw new Error("Cannot use both -merge and -draft options.\n\n" +
+            "  -merge  Auto-merge into base branch and cleanup after task completion\n" +
+            "  -draft  Auto-create a Draft PR after task completion\n\n" +
+            "Example:\n" +
+            "  claude-worktree feature/auth 'Implement auth' -merge\n" +
+            "  claude-worktree feature/auth 'Implement auth' -draft -base main");
+    }
+    const inlinePrompt = remaining.join(" ").trim();
+    // Mutual exclusivity check: cannot specify both -plan and inline prompt
+    if (planFile && inlinePrompt) {
+        throw new Error("Cannot use both -plan and inline prompt. Please use one or the other.");
+    }
+    // Require either inline prompt or -plan
+    if (!inlinePrompt && !planFile) {
+        throw new Error(`A prompt or -plan option is required.\n\nUsage:\n  ${CREATE_USAGE}`);
+    }
+    return {
+        branchName,
+        prompt: inlinePrompt,
+        planFile,
+        danger,
+        merge,
+        draft,
+        baseBranch,
+        pane,
+        verbose,
+    };
+}
+export function parseCleanArgs(args) {
+    const { booleans } = extractOptions(args, {
+        options: {
+            force: { type: "boolean", flag: "-force", alias: "-f" },
+            all: { type: "boolean", flag: "-all", alias: "-a" },
+            dryRun: { type: "boolean", flag: "-dry-run", alias: "-n" },
+            verbose: { type: "boolean", flag: "-verbose", alias: "-v" },
+        },
+        unknownHandling: "error",
+        ignoredFlags: ["-h", "-help"],
+        unknownErrorPrefix: "Unknown option for clean command",
+    });
+    return {
+        force: booleans.force,
+        all: booleans.all,
+        dryRun: booleans.dryRun,
+        verbose: booleans.verbose,
+    };
+}
+export function parseListArgs(args) {
+    const { booleans } = extractOptions(args, {
+        options: {
+            json: { type: "boolean", flag: "-json", alias: "-j" },
+            status: { type: "boolean", flag: "-status", alias: "-s" },
+            verbose: { type: "boolean", flag: "-verbose", alias: "-v" },
+        },
+        unknownHandling: "error",
+        ignoredFlags: ["-h", "-help"],
+        unknownErrorPrefix: "Unknown option for list command",
+    });
+    return {
+        json: booleans.json,
+        verbose: booleans.verbose,
+        status: booleans.status,
+    };
+}
+export function parseArgs(args) {
+    // Internal sub-command: must be checked before help flags
+    if (args[0] === "_run-in-pane") {
+        if (args.length !== 2) {
+            throw new Error("_run-in-pane requires exactly one payload file path argument");
+        }
+        return { type: "_run-in-pane", payloadPath: args[1] };
+    }
+    // No args → global help
+    if (args.length === 0) {
+        return { type: "help" };
+    }
+    // Per-command help: list -h, clean -h
+    if (args[0] === "list") {
+        const subArgs = args.slice(1);
+        if (subArgs.includes("-h") || subArgs.includes("-help")) {
+            return { type: "help", commandHelp: "list" };
+        }
+        return { type: "list", args: parseListArgs(subArgs) };
+    }
+    if (args[0] === "clean") {
+        const subArgs = args.slice(1);
+        if (subArgs.includes("-h") || subArgs.includes("-help")) {
+            return { type: "help", commandHelp: "clean" };
+        }
+        return { type: "clean", args: parseCleanArgs(subArgs) };
+    }
+    // Global help flags (only when not a sub-command)
+    if (args.includes("-h") || args.includes("-help")) {
+        // If the first arg looks like a branch name (create command), show create help
+        if (args.length >= 1 && !args[0].startsWith("-") && args[0] !== "list" && args[0] !== "clean") {
+            return { type: "help", commandHelp: "create" };
+        }
+        return { type: "help" };
+    }
+    // Single non-flag argument that isn't a known command → unknown command error
+    if (args.length === 1 && !args[0].startsWith("-")) {
+        throw new Error(`Unknown command: ${args[0]}\n\n` +
+            `Available commands: list, clean\n\n` +
+            `To create a worktree:\n  ${CREATE_USAGE}`);
+    }
+    return { type: "create", args: parseCreateArgs(args) };
+}
+export async function run(command) {
+    switch (command.type) {
+        case "help":
+            if (command.commandHelp === "create") {
+                showCreateHelp();
+            }
+            else if (command.commandHelp === "list") {
+                showListHelp();
+            }
+            else if (command.commandHelp === "clean") {
+                showCleanHelp();
+            }
+            else {
+                showHelp();
+            }
+            break;
+        case "create":
+            await runCreate(command.args);
+            break;
+        case "list":
+            await executeList(command.args);
+            break;
+        case "clean":
+            await executeClean(command.args);
+            break;
+        case "_run-in-pane": {
+            const runInPaneArgs = await parseRunInPaneArgs(command.payloadPath);
+            await executeRunInPane(runInPaneArgs);
+            break;
+        }
+    }
+}
+//# sourceMappingURL=cli.js.map