feat: add CLI category creation and TUI entry editing

- Add `category add <name> [description]` CLI command for dynamic category creation
- Add TUI entry editing with 'e' key - edit IP, hostnames, comment, and category
- Implement AddCategory method in hosts parser with validation
- Add comprehensive test coverage for new features
- Update documentation (README.md, EXAMPLES.md, CLAUDE.md) with new functionality

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: Brandon H

CLAUDE.md

@@ -135,10 +135,23 @@ func newCmd() *cobra.Command {
 4. Document in README.md
 
 ### Adding New Categories
+
+**For programmatic categories (constants):**
 1. Add constant to `internal/hosts/types.go`
 2. Update default config in `internal/config/config.go`
 3. Document in user documentation
 
+**For dynamic categories (CLI and TUI):**
+Categories can now be created dynamically using:
+- **CLI**: `hosts-manager category add <name> [description]`
+- **TUI**: Press 'c' in the main view to create categories interactively
+
+**Implementation details:**
+- `AddCategory()` method in `internal/hosts/parser.go` handles category creation
+- Categories are validated using `validateCategoryName()` function
+- Empty categories are not written to hosts file (only categories with entries persist)
+- Both CLI and TUI support category creation with optional descriptions
+
 ### Platform-Specific Code
 Use the platform abstraction:
 ```go
@@ -173,6 +186,11 @@ type model struct {
     moveCategoryCursor int       // Move entry: target category cursor
     createCategoryName string    // Create category: name field
     createCategoryDescription string // Create category: description field
+    editEntryIndex    int        // Edit entry: index of entry being edited
+    editIP           string      // Edit entry: IP field
+    editHostnames    string      // Edit entry: hostnames field
+    editComment      string      // Edit entry: comment field
+    editCategory     string      // Edit entry: category field
 }
 ```
 
@@ -181,6 +199,7 @@ type model struct {
 - **viewSearch**: Real-time search and filtering
 - **viewHelp**: Help and keybinding information
 - **viewAdd**: Add new entry form with multi-field input
+- **viewEdit**: Edit existing entry with all fields (IP, hostnames, comment, category)
 - **viewMove**: Move entry between categories with guided selection
 - **viewCreateCategory**: Create new custom category with name/description
 
@@ -191,6 +210,7 @@ case "up", "k":     // Navigate up
 case "down", "j":   // Navigate down  
 case " ":           // Toggle entry enabled/disabled
 case "a":           // Add new entry
+case "e":           // Edit selected entry
 case "d":           // Delete selected entry
 case "m":           // Move entry to different category
 case "c":           // Create new category

EXAMPLES.md

@@ -87,6 +87,24 @@ sudo hosts-manager add 172.17.0.4 elasticsearch.docker --category development
 sudo hosts-manager add 192.168.65.2 app.docker --category development --comment "Docker Desktop VM"
 ```
 
+### Creating Custom Categories
+
+```bash
+# Create a custom category for specific projects
+sudo hosts-manager category add microservices "Microservices development environment"
+
+# Create categories for different client projects
+sudo hosts-manager category add client-alpha "Client Alpha project hosts"
+sudo hosts-manager category add client-beta "Client Beta project hosts"
+
+# Create environment-specific categories
+sudo hosts-manager category add testing "Integration testing environment"
+sudo hosts-manager category add demo "Demo environment for presentations"
+
+# Verify categories were created
+hosts-manager category list
+```
+
 ### Switching Between Environments
 
 ```bash
@@ -296,12 +314,37 @@ Press Enter to create category
 # Recommended workflow for bulk changes
 hosts-manager tui
 # 1. Search for entries: /development
-# 2. Toggle multiple entries with space
-# 3. Add new entries with 'a'
-# 4. Move entries between categories with 'm'
-# 5. Create custom categories with 'c'
-# 6. Save all changes with 's'
-# 7. Confirm save message appears
+# 2. Navigate with arrow keys or j/k
+# 3. Toggle multiple entries with space
+# 4. Edit existing entries with 'e'
+# 5. Add new entries with 'a'
+# 6. Move entries between categories with 'm'
+# 7. Create custom categories with 'c'
+# 8. Save all changes with 's'
+# 9. Confirm save message appears
+```
+
+**TUI Advanced Workflows:**
+
+```bash
+# Edit existing entries
+hosts-manager tui
+# 1. Find the entry you want to edit
+# 2. Press 'e' to enter edit mode
+# 3. Use Tab/Shift+Tab to navigate between fields:
+#    - IP Address
+#    - Hostnames (space separated)
+#    - Comment (optional)
+#    - Category
+# 4. Press Enter to save changes
+# 5. Press Esc to cancel
+
+# Bulk category management
+hosts-manager tui
+# 1. Create new categories with 'c'
+# 2. Select entries and move them with 'm'
+# 3. Use search ('/') to filter entries
+# 4. Save all changes with 's'
 ```
 
 ## Advanced Use Cases

README.md

@@ -183,6 +183,15 @@ hosts-manager restore hosts.backup.2023-12-07T10-30-45
 hosts-manager category list
 ```
 
+#### Add New Category
+```bash
+# Add category with name only
+hosts-manager category add testing
+
+# Add category with name and description
+hosts-manager category add testing "Testing environment hosts"
+```
+
 #### Enable/Disable Category
 ```bash
 hosts-manager category enable development
@@ -236,6 +245,7 @@ hosts-manager tui
 - `↑/↓` or `k/j` - Navigate entries
 - `space` - Toggle entry enabled/disabled
 - `a` - Add new entry
+- `e` - Edit selected entry
 - `d` - Delete entry
 - `m` - Move entry to different category
 - `c` - Create new category
@@ -245,7 +255,8 @@ hosts-manager tui
 - `?` - Help
 - `q` - Quit
 
-**New TUI Features:**
+**Advanced TUI Features:**
+- **Edit entries**: Use `e` to edit the selected entry's IP, hostnames, comment, and category
 - **Move entries**: Use `m` to move selected entry to a different category with guided interface
 - **Create categories**: Use `c` to create new custom categories with name and description
 

cmd/hosts-manager/commands.go

@@ -353,6 +353,7 @@ func categoryCmd() *cobra.Command {
 	}
 
 	cmd.AddCommand(categoryListCmd())
+	cmd.AddCommand(categoryAddCmd())
 	cmd.AddCommand(categoryEnableCmd())
 	cmd.AddCommand(categoryDisableCmd())
 
@@ -392,6 +393,68 @@ func categoryListCmd() *cobra.Command {
 	return cmd
 }
 
+func categoryAddCmd() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "add <name> [description]",
+		Short: "Add a new category",
+		Args:  cobra.RangeArgs(1, 2),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			p := platform.New()
+			if err := p.ElevateIfNeeded(); err != nil {
+				return err
+			}
+
+			parser := hosts.NewParser(p.GetHostsFilePath())
+			hostsFile, err := parser.Parse()
+			if err != nil {
+				return fmt.Errorf("failed to parse hosts file: %w", err)
+			}
+
+			categoryName := args[0]
+			description := ""
+			if len(args) > 1 {
+				description = args[1]
+			}
+
+			backupMgr := backup.NewManager(cfg)
+			if cfg.General.AutoBackup {
+				if _, err := backupMgr.CreateBackup(); err != nil {
+					return fmt.Errorf("failed to create backup: %w", err)
+				}
+				if verbose {
+					fmt.Println("Backup created successfully")
+				}
+			}
+
+			if dryRun {
+				fmt.Printf("Would add category: %s", categoryName)
+				if description != "" {
+					fmt.Printf(" - %s", description)
+				}
+				fmt.Println()
+				return nil
+			}
+
+			if err := hostsFile.AddCategory(categoryName, description); err != nil {
+				return fmt.Errorf("failed to add category: %w", err)
+			}
+
+			if err := hostsFile.Write(p.GetHostsFilePath()); err != nil {
+				return fmt.Errorf("failed to write hosts file: %w", err)
+			}
+
+			fmt.Printf("Added category: %s", categoryName)
+			if description != "" {
+				fmt.Printf(" - %s", description)
+			}
+			fmt.Println()
+			return nil
+		},
+	}
+
+	return cmd
+}
+
 func categoryEnableCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "enable <category>",