@jhorst11/wt 1.0.0

package/README.md

@@ -0,0 +1,104 @@
+# 🌳 wt-cli
+
+A beautiful, interactive CLI for managing git worktrees.
+
+![Demo](https://via.placeholder.com/800x400?text=wt-cli+Demo)
+
+## Features
+
+- ✨ **Interactive menus** - Create, list, and remove worktrees with ease
+- 🌿 **Smart branch handling** - Create from current branch, local branches, or remote branches
+- 🚀 **Quick navigation** - Jump between worktrees and back to home
+- 🎨 **Beautiful UI** - Modern CLI experience with colors, emojis, and spinners
+
+## Installation
+
+### Global Install (Recommended)
+
+```bash
+npm install -g .
+```
+
+Or if you want to install from the repo:
+
+```bash
+cd /path/to/wt
+npm install
+npm link
+```
+
+### Shell Integration
+
+To enable the `cd` functionality (jumping to worktrees), add this to your `.bashrc` or `.zshrc`:
+
+```bash
+# For wt-cli directory changing support
+source /path/to/wt/shell/wt.sh
+```
+
+Without this, the tool will show you the path to copy instead of auto-navigating.
+
+## Usage
+
+### Interactive Mode (Default)
+
+Just run `wt` with no arguments to open the interactive menu:
+
+```bash
+wt
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `wt` | Open interactive menu |
+| `wt new` | Create a new worktree |
+| `wt list` | List all worktrees for current repo |
+| `wt remove` | Remove a worktree |
+| `wt go [name]` | Jump to a worktree |
+| `wt home` | Return to the main repository |
+
+### Creating a Worktree
+
+```bash
+wt new
+```
+
+You'll be prompted to:
+1. Choose what to base your worktree on (current branch, local branch, remote branch, or new)
+2. Enter a name for your worktree
+3. Confirm creation
+
+### Configuration
+
+You can configure wt-cli via environment variables:
+
+```bash
+# Directory where your projects live
+export W_PROJECTS_DIR="$HOME/projects"
+
+# Directory where worktrees will be created
+export W_WORKTREES_DIR="$HOME/projects/worktrees"
+
+# Optional prefix for branch names (e.g., "username")
+export W_DEFAULT_BRANCH_PREFIX=""
+```
+
+## How It Works
+
+wt-cli creates worktrees in a structured directory based on your project:
+
+```
+~/projects/
+├── my-repo/              # Your main repository
+│   └── ...
+└── worktrees/
+    └── my-repo/          # Worktrees for my-repo
+        ├── feature-a/
+        └── feature-b/
+```
+
+## License
+
+MIT

package/bin/wt.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import {
+  mainMenu,
+  createWorktreeFlow,
+  listWorktrees,
+  removeWorktreeFlow,
+  mergeWorktreeFlow,
+  goHome,
+  goToWorktree,
+} from '../src/commands.js';
+import { showHelp, showLogo, spacer, colors } from '../src/ui.js';
+import { setupCommand } from '../src/setup.js';
+
+program
+  .name('wt')
+  .description('🌳 Beautiful interactive git worktree manager')
+  .version('1.0.0');
+
+program
+  .command('new', { isDefault: false })
+  .description('Create a new worktree interactively')
+  .action(createWorktreeFlow);
+
+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(removeWorktreeFlow);
+
+program
+  .command('merge')
+  .description('Merge a worktree branch back to main')
+  .action(mergeWorktreeFlow);
+
+program
+  .command('home')
+  .description('Return to the main repository')
+  .action(goHome);
+
+program
+  .command('go [name]')
+  .description('Jump to a worktree (interactive if no name)')
+  .action(goToWorktree);
+
+program
+  .command('setup')
+  .description('Configure shell integration for directory jumping')
+  .action(setupCommand);
+
+// Default action (no command = interactive menu)
+program.action(async () => {
+  const args = process.argv.slice(2);
+  if (args.length === 0) {
+    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();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@jhorst11/wt",
+  "version": "1.0.0",
+  "description": "🌳 Beautiful interactive git worktree manager",
+  "type": "module",
+  "bin": {
+    "wt": "./bin/wt.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "shell"
+  ],
+  "scripts": {
+    "start": "node bin/wt.js"
+  },
+  "keywords": [
+    "git",
+    "worktree",
+    "cli",
+    "interactive",
+    "terminal",
+    "workflow"
+  ],
+  "author": "Justin Horst",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jhorst11/wt.git"
+  },
+  "homepage": "https://github.com/jhorst11å/wt#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.2.1",
+    "chalk": "^5.3.0",
+    "cli-spinners": "^3.2.0",
+    "commander": "^13.0.0",
+    "figures": "^6.1.0",
+    "gradient-string": "^3.0.0",
+    "ora": "^8.1.1",
+    "simple-git": "^3.27.0"
+  }
+}

package/shell/wt.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Shell wrapper for wt-cli to enable directory changing
+# Add this to your .bashrc or .zshrc:
+#   source /path/to/wt/shell/wt.sh
+
+# Find the wt binary - works whether installed globally or locally
+_wt_find_bin() {
+  if command -v wt &>/dev/null; then
+    echo "wt"
+  elif [[ -f "$HOME/.npm-global/bin/wt" ]]; then
+    echo "$HOME/.npm-global/bin/wt"
+  elif [[ -f "$(npm root -g 2>/dev/null)/wt-cli/bin/wt.js" ]]; then
+    echo "node $(npm root -g)/wt-cli/bin/wt.js"
+  else
+    echo "wt"
+  fi
+}
+
+wt() {
+  local wt_bin=$(_wt_find_bin)
+  local wt_cd_file="/tmp/wt_cd_$$"
+
+  # Clean up any old cd file
+  rm -f "$wt_cd_file"
+
+  # Run wt with env vars so it knows we can handle cd
+  WT_WRAPPER=1 WT_CD_FILE="$wt_cd_file" $wt_bin "$@"
+  local exit_code=$?
+
+  # Check if wt wrote a cd path
+  if [[ -f "$wt_cd_file" ]]; then
+    local dir=$(cat "$wt_cd_file")
+    rm -f "$wt_cd_file"
+    [[ -d "$dir" ]] && cd "$dir"
+  fi
+
+  return $exit_code
+}
+
+# Tab completion for bash
+if [[ -n "$BASH_VERSION" ]]; then
+  _wt_completions() {
+    local cur="${COMP_WORDS[COMP_CWORD]}"
+    local commands="new list ls remove rm home go setup"
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+  }
+  complete -F _wt_completions wt
+fi
+
+# Tab completion for zsh
+if [[ -n "$ZSH_VERSION" ]]; then
+  _wt_completions() {
+    local commands=(
+      'new:Create a new worktree'
+      'list:List all worktrees'
+      'ls:List all worktrees'
+      'remove:Remove a worktree'
+      'rm:Remove a worktree'
+      'home:Return to main repo'
+      'go:Jump to a worktree'
+      'setup:Configure shell integration'
+    )
+    _describe 'command' commands
+  }
+  compdef _wt_completions wt
+fi