refactor: simplify to menu-only interface with comprehensive docs and fixes

Author: wasabeef

.git-workers.toml

@@ -0,0 +1,23 @@
+# Git Workers configuration file
+
+[repository]
+# Repository URL for identification (optional)
+# This ensures hooks only run in the intended repository
+url = "https://github.com/wasabeef/git-workers.git"
+
+[hooks]
+# Run after creating a new worktree
+post-create = [
+    "echo '🤖 Created worktree: {{worktree_name}}'",
+    "echo '🤖 Path: {{worktree_path}}'"
+]
+
+# Run before removing a worktree
+pre-remove = [
+    "echo '🤖 Removing worktree: {{worktree_name}}'"
+]
+
+# Run after switching to a worktree
+post-switch = [
+    "echo 'S🤖 witched to: {{worktree_name}}'"
+]

CHANGELOG.md

@@ -1,17 +1,86 @@
 # Changelog
 
-Please see [GitHub Releases](https://github.com/wasabeef/git-workers/releases) for the complete changelog.
+All notable changes to Git Workers will be documented in this file.
 
-Each release includes:
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-- Detailed release notes generated from commit history
-- Binary downloads for all supported platforms
-- Installation instructions
+For detailed release notes and binary downloads, see [GitHub Releases](https://github.com/wasabeef/git-workers/releases).
 
-The release notes are automatically generated using conventional commits, categorizing changes into:
+## [Unreleased]
 
-- Features
-- Bug Fixes
-- Documentation
-- Performance improvements
-- And more
+### Changed
+
+- **BREAKING**: Removed command-line argument options (--list, --create, etc.) in favor of interactive menu-only interface
+- Simplified main.rs to focus solely on interactive menu operations
+- Improved worktree rename functionality with `git worktree repair` integration
+- Enhanced configuration lookup strategy:
+  - Now checks current directory first (useful for bare repo worktrees)
+  - Then checks parent directory's main/master worktree
+  - Finally falls back to repository root
+- Improved path handling for worktree creation:
+  - Paths are now canonicalized to eliminate "../" in display
+  - "In subdirectory" option now correctly creates worktrees in subdirectories
+
+### Added
+
+- Edit hooks menu option (`λ`) for managing lifecycle hooks through the interface
+- Comprehensive Rustdoc documentation for all modules and functions
+- Current directory configuration lookup priority for .git-workers.toml
+- Parent directory configuration lookup for .git-workers.toml
+- Better error handling with mutex poison recovery in tests
+- Branch deletion functionality in batch delete operations
+- Orphaned branch detection when deleting worktrees
+- Repository URL validation in configuration files
+- New test files for batch delete and edit hooks functionality
+
+### Fixed
+
+- All clippy warnings resolved:
+  - manual_div_ceil replaced with div_ceil() method
+  - manual_unwrap_or patterns simplified
+  - needless_borrows in format! macros removed
+  - useless_vec replaced with arrays
+  - manual_flatten replaced with .flatten() method
+- Test failures related to parent directory configuration search
+- ESC cancellation pattern tests updated for new code style
+- Worktree rename test expectations aligned with Git limitations
+- "In subdirectory" option now correctly creates worktrees in worktrees/ folder
+- Path display now shows clean canonical paths without "../"
+- Batch delete now properly deletes orphaned branches
+- Edit hooks no longer incorrectly identifies regular repos as bare
+
+### Documentation
+
+- Updated README.md with current features and usage:
+  - Added configuration file lookup priority documentation
+  - Updated worktree pattern examples
+  - Added custom path creation examples
+  - Added repository URL configuration example
+  - Clarified batch delete branch deletion functionality
+- Enhanced CLAUDE.md with architectural details and development commands
+- Added detailed inline documentation for all public APIs
+- Updated all Rustdoc comments to reflect recent changes
+
+## [0.1.0] - 2024-12-17
+
+### Added
+
+- Initial release of Git Workers
+- Interactive menu-driven interface for Git worktree management
+- List worktrees with detailed status information (branch, changes, ahead/behind)
+- Fuzzy search through worktrees with real-time filtering
+- Create new worktrees from branches or HEAD
+- Delete single or multiple worktrees with safety checks
+- Switch worktrees with automatic directory change via shell integration
+- Rename worktrees and optionally their branches
+- Cleanup old worktrees by age
+- Hook system for lifecycle events (post-create, pre-remove, post-switch)
+- Shell integration for Bash and Zsh
+- Configuration file support (.git-workers.toml)
+- Template variable support in hooks ({{worktree_name}}, {{worktree_path}})
+- Worktree pattern detection for organized directory structure
+- ESC key support for cancelling operations
+- Colored terminal output with theme support
+- Progress indicators for long operations
+- Homebrew installation support

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-Git Workers is an interactive CLI tool for managing Git worktrees, written in Rust. It provides a menu-driven interface for creating, deleting, switching, and renaming worktrees, with shell integration for automatic directory switching.
+Git Workers is an interactive CLI tool for managing Git worktrees, written in Rust. It provides a menu-driven interface for creating, deleting, switching, and renaming worktrees, with shell integration for automatic directory switching. The tool focuses on simplicity and user experience, offering only interactive menu-based operations without command-line arguments (except for --version and --help).
 
 ## Development Commands
 
@@ -100,26 +100,44 @@ Automatic directory switching on worktree change requires special implementation
 Define lifecycle hooks in `.git-workers.toml`:
 
 ```toml
+[repository]
+# Optional: Repository URL validation
+url = "https://github.com/owner/repo.git"
+
 [hooks]
 post-create = ["npm install", "cp .env.example .env"]
 pre-remove = ["rm -rf node_modules"]
 post-switch = ["echo 'Switched to {{worktree_name}}'"]
 ```
 
 Template variables:
-
 - `{{worktree_name}}`: The worktree name
 - `{{worktree_path}}`: Absolute path to worktree
 
+### Configuration File Loading
+
+Configuration is loaded in priority order:
+1. Current directory (useful for bare repo worktrees)
+2. Parent directory's main/master worktree
+3. Repository root
+
+This flexible strategy ensures hooks work in both regular and bare repositories.
+
 ### Worktree Patterns
 
 First worktree creation offers two options:
-
 1. Same level as repository: `../worktree-name`
-2. In subdirectory (recommended): `../repo/worktrees/worktree-name`
+2. In subdirectory (recommended): `repo/worktrees/worktree-name`
 
 Subsequent worktrees follow the established pattern automatically.
 
+### Path Handling
+
+- Paths starting with `../` create worktrees at repository parent level
+- Paths containing `/` (e.g., `worktrees/feature`) create within repository
+- Simple names use pattern detection from existing worktrees
+- All paths are canonicalized to eliminate `../` in display
+
 ### ESC Key Handling
 
 All interactive prompts support ESC cancellation through custom `input_esc_raw` module:
@@ -131,11 +149,21 @@ All interactive prompts support ESC cancellation through custom `input_esc_raw`
 ### Worktree Rename Implementation
 
 Since Git lacks native rename functionality:
-
 1. Move directory with `fs::rename`
 2. Update `.git/worktrees/<name>` metadata directory
 3. Update gitdir files in both directions
-4. Optionally rename associated branch if it matches worktree name
+4. Run `git worktree repair` to update Git's tracking
+5. Optionally rename associated branch if it matches worktree name
+
+Note: Due to Git limitations, the worktree will still be tracked with its original name internally, but the directory will be renamed.
+
+### Batch Delete Features
+
+- Multi-select interface for choosing multiple worktrees
+- Automatic detection of orphaned branches (using `is_branch_unique_to_worktree`)
+- Separate confirmations for worktree and branch deletion
+- Executes pre-remove hooks for each worktree
+- Reports success/failure counts separately for worktrees and branches
 
 ### CI/CD Configuration
 

Cargo.lock

@@ -37,6 +37,7 @@ chrono = "0.4"
 fuzzy-matcher = "0.3"
 indicatif = "0.17"
 rustyline = "14.0"
+unicode-width = "0.2.1"
 
 [dev-dependencies]
 tempfile = "3.8"

Cargo.toml

@@ -9,14 +9,15 @@ https://github.com/user-attachments/assets/bb58444f-4936-411c-be51-62faf08fe9a0
 
 ## Features
 
-- 📋 List worktrees with status information
+- 📋 List worktrees with detailed status information (branch, changes, ahead/behind)
 - 🔍 Fuzzy search through worktrees
 - ➕ Create new worktrees from branches or HEAD
 - ➖ Delete single or multiple worktrees
 - 🔄 Switch worktrees with automatic directory change
 - ✏️ Rename worktrees and optionally their branches
 - 🧹 Cleanup old worktrees by age
 - 🪝 Execute hooks on worktree lifecycle events
+- 📝 Edit and manage hooks through the interface
 
 ## Installation
 
@@ -26,6 +27,14 @@ https://github.com/user-attachments/assets/bb58444f-4936-411c-be51-62faf08fe9a0
 brew install wasabeef/gw-tap/gw
 ```
 
+### From Source
+
+```bash
+git clone https://github.com/wasabeef/git-workers.git
+cd git-workers
+cargo install --path .
+```
+
 ### Shell Integration
 
 To enable automatic directory switching when switching worktrees, add this to your shell config:
@@ -35,6 +44,12 @@ To enable automatic directory switching when switching worktrees, add this to yo
 source $(brew --prefix)/share/gw/shell/gw.sh
 ```
 
+For manual installation, use the path where git-workers is installed:
+
+```bash
+source /path/to/git-workers/shell/gw.sh
+```
+
 ## Usage
 
 Run `gw` in any Git repository:
@@ -43,18 +58,84 @@ Run `gw` in any Git repository:
 gw
 ```
 
-### Menu Options
+### Interactive Menu
+
+Git Workers provides an interactive menu-driven interface. Simply run `gw` and navigate through the options:
 
-- **List worktrees** (`•`): Display all worktrees with status information
-- **Search worktrees** (`?`): Fuzzy search through worktrees
-- **Create worktree** (`+`): Create a new worktree
-- **Delete worktree** (`-`): Delete a single worktree
-- **Batch delete** (`=`): Delete multiple worktrees at once
+- **List worktrees** (`•`): Display all worktrees with branch, changes, and sync status
+- **Search worktrees** (`?`): Fuzzy search through worktree names and branches
+- **Create worktree** (`+`): Create a new worktree from existing branch or create a new branch
+- **Delete worktree** (`-`): Delete a single worktree with safety checks
+- **Batch delete** (`=`): Select and delete multiple worktrees at once (optionally deletes orphaned branches)
 - **Cleanup old worktrees** (`~`): Remove worktrees older than specified days
-- **Switch worktree** (`→`): Switch to another worktree (changes directory)
-- **Rename worktree** (`*`): Rename an existing worktree
+- **Switch worktree** (`→`): Switch to another worktree (automatically changes directory)
+- **Rename worktree** (`*`): Rename worktree directory and optionally its branch
+- **Edit hooks** (`λ`): Configure lifecycle hooks in `.git-workers.toml`
 - **Exit** (`x`): Exit the application
 
+### Configuration
+
+Git Workers uses `.git-workers.toml` for configuration. The file is loaded from (in order of priority):
+1. Current directory (useful for bare repository worktrees)
+2. Parent directory's main/master worktree (for organized worktree structures)
+3. Repository root
+
+```toml
+[repository]
+# Optional: Specify repository URL to ensure hooks only run in the intended repository
+# url = "https://github.com/owner/repo.git"
+
+[hooks]
+# Execute after creating a new worktree
+post-create = [
+    "npm install",
+    "cp .env.example .env",
+    "echo 'Worktree {{worktree_name}} created at {{worktree_path}}'"
+]
+
+# Execute before removing a worktree
+pre-remove = [
+    "echo 'Cleaning up {{worktree_name}}'",
+    "rm -rf node_modules"
+]
+
+# Execute after switching to a worktree
+post-switch = [
+    "echo 'Switched to {{worktree_name}}'"
+]
+```
+
+### Hook Variables
+
+- `{{worktree_name}}`: The name of the worktree
+- `{{worktree_path}}`: The absolute path to the worktree
+
+### Worktree Patterns
+
+When creating your first worktree, Git Workers offers two patterns:
+
+1. **Same level as repository**: Creates worktrees as siblings to your main repository
+   ```
+   parent/
+   ├── my-repo/
+   ├── feature-1/
+   └── feature-2/
+   ```
+
+2. **In subdirectory** (recommended): Organizes worktrees in a dedicated directory
+   ```
+   parent/
+   └── my-repo/
+       └── worktrees/
+           ├── feature-1/
+           └── feature-2/
+   ```
+
+You can also create worktrees with custom paths:
+- `../feature`: Creates at the same level as the repository
+- `worktrees/feature`: Creates in a subdirectory
+- `branch/feature`: Creates in a custom subdirectory structure
+
 ### Keyboard Shortcuts
 
 - **ESC**: Cancel current operation and return to menu