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 'Switched to: {{worktree_name}}'"
+]

CHANGELOG.md

@@ -1,17 +1,64 @@
 # 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 to search parent directories
+
+### Added
+
+- Edit hooks menu option (`λ`) for managing lifecycle hooks through the interface
+- Comprehensive Rustdoc documentation for all modules and functions
+- Parent directory configuration lookup for .git-workers.toml
+- Better error handling with mutex poison recovery in tests
+
+### 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
+- 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
+
+### Documentation
+
+- Updated README.md with current features and usage
+- Enhanced CLAUDE.md with architectural details
+- Added detailed inline documentation for all public APIs
+
+## [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
 
@@ -135,7 +135,10 @@ 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.
 
 ### 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,73 @@ 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
 - **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. Place this file in your repository root:
+
+```toml
+[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/
+   ├── my-repo-feature-1/
+   └── my-repo-feature-2/
+   ```
+
+2. **In subdirectory** (recommended): Organizes worktrees in a dedicated directory
+   ```
+   parent/
+   └── my-repo/
+       └── worktrees/
+           ├── feature-1/
+           └── feature-2/
+   ```
+
 ### Keyboard Shortcuts
 
 - **ESC**: Cancel current operation and return to menu