@jhorst11/wt 2.0.1 → 2.1.0

package/README.md

@@ -107,6 +107,9 @@ Create `<repo>/.wt/config.json`:
     "post-create": [
       "npm install",
       "cp $WT_SOURCE/.env .env"
+    ],
+    "pre-destroy": [
+      "npm run clean"
     ]
   }
 }
@@ -120,16 +123,49 @@ Create `<repo>/.wt/config.json`:
 | `worktreesDir` | `string` | `~/projects/worktrees` | Directory where worktrees are created |
 | `branchPrefix` | `string` | `""` | Prefix for branch names (e.g., "username/") |
 | `hooks.post-create` | `string[]` | `[]` | Shell commands to run after creating a worktree |
+| `hooks.pre-destroy` | `string[]` | `[]` | Shell commands to run before removing a worktree |
 
 **Hook environment variables** (available in hook commands):
 
 | Variable | Description |
 |----------|-------------|
 | `WT_SOURCE` | Absolute path to the main repository |
-| `WT_BRANCH` | Branch name of the new worktree |
-| `WT_PATH` | Absolute path to the new worktree (also the cwd) |
+| `WT_BRANCH` | Branch name of the worktree |
+| `WT_PATH` | Absolute path to the worktree (also the cwd) |
+| `WT_NAME` | Worktree name (directory name, e.g. `feature-a`) |
+| `WT_COLOR` | Hex color assigned to this worktree (e.g. `#E53935`), for UI/theming |
 
-Hook commands run with cwd set to the new worktree path. If a hook command fails, a warning is shown but the worktree creation still succeeds.
+Each new worktree is assigned a unique color from a fixed palette (stored in `<repo>/.wt/worktree-colors.json`). In supported terminals (iTerm2, WezTerm, Ghostty, Kitty, Windows Terminal, Alacritty), the tab color is set to that worktree's color when you create a worktree or run `wt go <name>`. Colors also appear as indicators (●) throughout the CLI UI.
+
+Hook commands run with cwd set to the worktree path. To run a Node script that lives in the main repo (e.g. `<repo>/.wt/scripts/foo.js`), use `WT_SOURCE`: `node "$WT_SOURCE/.wt/scripts/foo.js"` — `./scripts/foo.js` would look inside the worktree, not the main repo. If a hook command fails, a warning is shown but the operation continues (worktree creation still succeeds; worktree removal still proceeds after pre-destroy).
+
+#### Worktree Color Configuration
+
+Override automatic colors or provide a custom palette:
+
+**Manual color assignment** (`.wt/config.json`):
+
+```json
+{
+  "worktreeColors": {
+    "feature-auth": "#FF5733",
+    "feature-payments": "#33FF57"
+  }
+}
+```
+
+**Custom color palette** (`.wt/config.json`):
+
+```json
+{
+  "colorPalette": [
+    "#FF6B6B", "#4ECDC4", "#45B7D1", "#FFA07A",
+    "#98D8C8", "#F7DC6F", "#BB8FCE", "#85C1E2"
+  ]
+}
+```
+
+Colors are stored per-repository in `.wt/worktree-colors.json` and support hierarchical configuration (global → repo → directory overrides).
 
 ## How It Works
 

package/dist/bin/wt.d.ts

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

package/dist/bin/wt.d.ts.map

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

package/dist/bin/wt.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { program } from 'commander';
+import { mainMenu, createWorktreeFlow, listWorktrees, removeWorktreeFlow, mergeWorktreeFlow, goHome, goToWorktree, } from '../src/commands.js';
+import { spacer, colors } from '../src/ui.js';
+import { setupCommand } from '../src/setup.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+// Resolve package.json relative to project root (one level up from bin/)
+const packagePath = join(__dirname, '..', '..', 'package.json');
+const { version } = require(packagePath);
+program
+    .name('wt')
+    .description('🌳 Beautiful interactive git worktree manager')
+    .version(version)
+    .option('--verbose', 'Show full hook command output (default: show command name with spinner only)');
+program
+    .command('new', { isDefault: false })
+    .description('Create a new worktree interactively')
+    .option('--no-hooks', 'Skip post-create hooks')
+    .action((args, cmd) => {
+    createWorktreeFlow({ verbose: !!cmd.parent?.opts?.()?.verbose, hooks: args.hooks });
+});
+program
+    .command('list')
+    .alias('ls')
+    .description('List all worktrees for the current repo')
+    .action(listWorktrees);
+program
+    .command('remove')
+    .alias('rm')
+    .description('Remove a worktree interactively')
+    .action((_args, cmd) => {
+    removeWorktreeFlow({ verbose: !!cmd.parent?.opts?.()?.verbose });
+});
+program
+    .command('merge')
+    .description('Merge a worktree branch back to main')
+    .action((_args, cmd) => {
+    mergeWorktreeFlow({ verbose: !!cmd.parent?.opts?.()?.verbose });
+});
+program
+    .command('home')
+    .description('Return to the main repository')
+    .action(goHome);
+program
+    .command('go [name]')
+    .alias('jump')
+    .description('Jump to a worktree (interactive if no name)')
+    .action((name) => {
+    goToWorktree(name);
+});
+program
+    .command('setup')
+    .description('Configure shell integration for directory jumping')
+    .action(setupCommand);
+// Default action (no command = interactive menu)
+program.action(async () => {
+    await mainMenu();
+});
+// Custom help
+program.on('--help', () => {
+    spacer();
+    console.log('Examples:');
+    console.log(`  ${colors.muted('$')} wt              ${colors.muted('# Interactive menu')}`);
+    console.log(`  ${colors.muted('$')} wt new          ${colors.muted('# Create new worktree')}`);
+    console.log(`  ${colors.muted('$')} wt list         ${colors.muted('# List all worktrees')}`);
+    console.log(`  ${colors.muted('$')} wt go feature-x ${colors.muted('# Jump to worktree')}`);
+    console.log(`  ${colors.muted('$')} wt merge        ${colors.muted('# Merge worktree to main')}`);
+    console.log(`  ${colors.muted('$')} wt home         ${colors.muted('# Return to main repo')}`);
+    console.log(`  ${colors.muted('$')} wt setup        ${colors.muted('# Configure shell integration')}`);
+    spacer();
+});
+// Handle graceful exit
+process.on('SIGINT', () => {
+    console.log('\n');
+    process.exit(0);
+});
+program.parse();
+//# sourceMappingURL=wt.js.map

package/dist/bin/wt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wt.js","sourceRoot":"","sources":["../../bin/wt.ts"],"names":[],"mappings":"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"}

package/dist/src/commands.d.ts

@@ -0,0 +1,9 @@
+import type { CommandOptions } from './types.js';
+export declare function mainMenu(): Promise<void>;
+export declare function createWorktreeFlow(options?: CommandOptions): Promise<void>;
+export declare function listWorktrees(): Promise<void>;
+export declare function removeWorktreeFlow(options?: CommandOptions): Promise<void>;
+export declare function mergeWorktreeFlow(options?: CommandOptions): Promise<void>;
+export declare function goHome(): Promise<void>;
+export declare function goToWorktree(name?: string): Promise<void>;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAuB/D,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA+H9C;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2QpF;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAyCnD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2KpF;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiQnF;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAuC5C;AAED,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgG/D"}