feat: Add Go, Python, Rust, and Homebrew scanning support, extend ScanOptions with new types, and enhance scan command documentation and TUI features.

Author: thanhdevapp

cmd/root/clean.go

@@ -27,18 +27,54 @@ var (
 
 // cleanCmd represents the clean command
 var cleanCmd = &cobra.Command{
-	Use:   "clean",
+	Use:   "clean [flags]",
 	Short: "Clean development artifacts",
 	Long: `Interactively select and clean development artifacts.
 
-By default, runs in TUI mode with interactive selection.
-Use --confirm to actually delete files (default is dry-run).
+By default, runs in TUI mode with interactive selection and dry-run
+enabled (preview only). Use --confirm to actually delete files.
+
+The TUI provides:
+  • Real-time deletion progress with package-manager style output
+  • Tree navigation for exploring nested folders
+  • Quick single-item cleanup or batch operations
+  • All operations logged to ~/.dev-cleaner.log
+
+Safety Features:
+  ✓ Dry-run mode by default (files are safe)
+  ✓ Confirmation required before deletion
+  ✓ Path validation (never touches system files)
+  ✓ All actions logged for audit trail
 
 Examples:
-  dev-cleaner clean              # Interactive TUI (dry-run)
-  dev-cleaner clean --confirm    # Interactive TUI (actually delete)
-  dev-cleaner clean --no-tui     # Simple text mode
-  dev-cleaner clean --ios        # Clean iOS artifacts only`,
+  dev-cleaner clean                   # Interactive TUI (dry-run)
+  dev-cleaner clean --confirm         # Interactive TUI (actually delete)
+  dev-cleaner clean --no-tui          # Simple text mode
+  dev-cleaner clean --ios --confirm   # Clean iOS artifacts only
+  dev-cleaner clean --node            # Preview Node.js cleanup (dry-run)
+
+Flags:
+  --confirm         Actually delete files (disables dry-run)
+  --dry-run         Preview only, don't delete (default: true)
+  --ios             Clean iOS/Xcode artifacts only
+  --android         Clean Android/Gradle artifacts only
+  --node            Clean Node.js artifacts only
+  --flutter         Clean Flutter/Dart artifacts only
+  --no-tui, -T      Disable TUI, use simple text mode
+  --tui             Use interactive TUI mode (default: true)
+
+TUI Keyboard Shortcuts:
+  c            Quick clean current item (ignores selections)
+  Enter        Clean all selected items (batch mode)
+  Space        Toggle selection
+  a/n          Select all / none
+  →/l          Enter tree mode (explore folders)
+  ?            Show help screen
+
+Important:
+  • 'c' clears all selections and cleans ONLY the current item
+  • 'Enter' cleans ALL selected items (batch operation)
+  • Tree mode allows deletion at any folder level`,
 	Run: runClean,
 }
 

cmd/root/root.go

@@ -20,16 +20,47 @@ var rootCmd = &cobra.Command{
 	Long: `Mac Dev Cleaner - A CLI tool to clean development project artifacts
 
 Quickly free up disk space by removing:
-  • Xcode DerivedData and caches
-  • Android Gradle caches
+  • Xcode DerivedData, Archives, and caches
+  • Android Gradle caches and SDK artifacts
   • Node.js node_modules directories
   • Package manager caches (npm, yarn, pnpm, bun)
+  • Flutter/Dart build artifacts and pub-cache
 
-Examples:
-  dev-cleaner scan              # Scan and show all cleanable items
-  dev-cleaner scan --ios        # Scan iOS/Xcode only
-  dev-cleaner clean             # Interactive clean (dry-run by default)
-  dev-cleaner clean --confirm   # Actually delete selected items`,
+Features:
+  ✨ Interactive TUI with keyboard navigation
+  ✨ Tree mode for exploring nested folders
+  ✨ Dry-run mode by default (safe preview)
+  ✨ Quick clean with single keypress
+  ✨ Batch operations for multiple items
+  ✨ Real-time deletion progress tracking
+
+Scan Examples:
+  dev-cleaner scan                    # Scan all + launch TUI
+  dev-cleaner scan --ios              # Scan iOS/Xcode only
+  dev-cleaner scan --android          # Scan Android/Gradle only
+  dev-cleaner scan --node             # Scan Node.js artifacts only
+  dev-cleaner scan --flutter          # Scan Flutter/Dart only
+  dev-cleaner scan --no-tui           # Text output without TUI
+
+Clean Examples:
+  dev-cleaner clean                   # Interactive TUI (dry-run)
+  dev-cleaner clean --confirm         # Interactive TUI (actually delete)
+  dev-cleaner clean --ios --confirm   # Clean iOS artifacts only
+  dev-cleaner clean --no-tui          # Simple text mode cleanup
+
+TUI Keyboard Shortcuts:
+  ↑/↓, k/j     Navigate up/down
+  Space        Toggle selection
+  a            Select all items
+  n            Deselect all items
+  c            Quick clean current item (single-item mode)
+  Enter        Clean all selected items (batch mode)
+  →/l          Drill down into folder (tree mode)
+  ←/h          Go back to parent (in tree mode)
+  ?            Show detailed help screen
+  q            Quit
+
+Tip: Use 'dev-cleaner scan' to start the interactive TUI mode!`,
 	Version: Version,
 }
 

cmd/root/scan.go

@@ -22,17 +22,43 @@ var (
 
 // scanCmd represents the scan command
 var scanCmd = &cobra.Command{
-	Use:   "scan",
+	Use:   "scan [flags]",
 	Short: "Scan for development artifacts",
 	Long: `Scan your system for development artifacts that can be cleaned.
 
-By default, opens interactive TUI for selection.
-Use --no-tui for simple text output.
+By default, scans all supported categories and opens interactive TUI
+for browsing, selection, and cleanup. The TUI provides tree navigation,
+keyboard shortcuts, and real-time deletion progress.
+
+Categories Scanned:
+  • Xcode (DerivedData, Archives, CoreSimulator, CocoaPods)
+  • Android (Gradle caches, SDK system images)
+  • Node.js (node_modules, npm/yarn/pnpm/bun caches)
+  • Flutter (build artifacts, .pub-cache, .dart_tool)
 
 Examples:
-  dev-cleaner scan              # Scan + TUI (default)
-  dev-cleaner scan --no-tui     # Scan + text output
-  dev-cleaner scan --ios        # Scan iOS/Xcode only`,
+  dev-cleaner scan                    # Scan all, launch TUI (default)
+  dev-cleaner scan --ios              # Scan iOS/Xcode only
+  dev-cleaner scan --android          # Scan Android only
+  dev-cleaner scan --node             # Scan Node.js only
+  dev-cleaner scan --flutter          # Scan Flutter only
+  dev-cleaner scan --no-tui           # Text output without TUI
+
+Flags:
+  --ios             Scan iOS/Xcode artifacts only
+  --android         Scan Android/Gradle artifacts only
+  --node            Scan Node.js artifacts only
+  --flutter         Scan Flutter/Dart artifacts only
+  --no-tui, -T      Disable TUI, show simple text output
+  --all             Scan all categories (default: true)
+
+TUI Features:
+  • Navigate with arrow keys or vim bindings (k/j/h/l)
+  • Select items with Space, 'a' for all, 'n' for none
+  • Quick clean single item with 'c'
+  • Batch clean selected items with Enter
+  • Drill down into folders with → or 'l'
+  • Press '?' for detailed help`,
 	Run: runScan,
 }
 

internal/cleaner/cleaner.go

@@ -53,6 +53,11 @@ func (c *Cleaner) SetDryRun(dryRun bool) {
 	c.dryRun = dryRun
 }
 
+// Logger returns the cleaner's logger instance
+func (c *Cleaner) Logger() *log.Logger {
+	return c.logger
+}
+
 // CleanResult represents the result of a clean operation
 type CleanResult struct {
 	Path        string

internal/scanner/golang.go

@@ -0,0 +1,84 @@
+package scanner
+
+import (
+	"os"
+	"path/filepath"
+
+	"github.com/thanhdevapp/dev-cleaner/pkg/types"
+)
+
+// getGOCACHE returns GOCACHE path or default
+func getGOCACHE() string {
+	if gocache := os.Getenv("GOCACHE"); gocache != "" {
+		return gocache
+	}
+	// macOS default
+	home, _ := os.UserHomeDir()
+	return filepath.Join(home, "Library", "Caches", "go-build")
+}
+
+// getGOMODCACHE returns GOMODCACHE path or default
+func getGOMODCACHE() string {
+	if gomodcache := os.Getenv("GOMODCACHE"); gomodcache != "" {
+		return gomodcache
+	}
+	// Default: $GOPATH/pkg/mod or ~/go/pkg/mod
+	gopath := os.Getenv("GOPATH")
+	if gopath == "" {
+		home, _ := os.UserHomeDir()
+		gopath = filepath.Join(home, "go")
+	}
+	return filepath.Join(gopath, "pkg", "mod")
+}
+
+// ScanGo scans for Go development artifacts
+func (s *Scanner) ScanGo(maxDepth int) []types.ScanResult {
+	var results []types.ScanResult
+
+	// Go build cache
+	gocache := getGOCACHE()
+	if s.PathExists(gocache) {
+		size, count, err := s.calculateSize(gocache)
+		if err == nil && size > 0 {
+			results = append(results, types.ScanResult{
+				Path:      gocache,
+				Type:      types.TypeGo,
+				Size:      size,
+				FileCount: count,
+				Name:      "Go Build Cache",
+			})
+		}
+	}
+
+	// Go module cache
+	gomodcache := getGOMODCACHE()
+	if s.PathExists(gomodcache) {
+		size, count, err := s.calculateSize(gomodcache)
+		if err == nil && size > 0 {
+			results = append(results, types.ScanResult{
+				Path:      gomodcache,
+				Type:      types.TypeGo,
+				Size:      size,
+				FileCount: count,
+				Name:      "Go Module Cache",
+			})
+		}
+	}
+
+	// Go test cache (same location as build cache typically)
+	gotestcache := os.Getenv("GOTESTCACHE")
+	if gotestcache != "" && gotestcache != gocache && s.PathExists(gotestcache) {
+		size, count, err := s.calculateSize(gotestcache)
+		if err == nil && size > 0 {
+			results = append(results, types.ScanResult{
+				Path:      gotestcache,
+				Type:      types.TypeGo,
+				Size:      size,
+				FileCount: count,
+				Name:      "Go Test Cache",
+			})
+		}
+	}
+
+	return results
+}

internal/scanner/homebrew.go

@@ -0,0 +1,45 @@
+package scanner
+
+import (
+	"github.com/thanhdevapp/dev-cleaner/pkg/types"
+)
+
+// HomebrewPaths contains Homebrew cache paths
+var HomebrewPaths = []struct {
+	Path string
+	Name string
+}{
+	// User cache
+	{"~/Library/Caches/Homebrew", "Homebrew Cache"},
+	// Apple Silicon Homebrew
+	{"/opt/homebrew/Library/Caches/Homebrew", "Homebrew Cache (ARM)"},
+	// Intel Homebrew
+	{"/usr/local/Homebrew/Library/Caches/Homebrew", "Homebrew Cache (Intel)"},
+}
+
+// ScanHomebrew scans for Homebrew caches
+func (s *Scanner) ScanHomebrew() []types.ScanResult {
+	var results []types.ScanResult
+
+	for _, target := range HomebrewPaths {
+		path := s.ExpandPath(target.Path)
+		if !s.PathExists(path) {
+			continue
+		}
+
+		size, count, err := s.calculateSize(path)
+		if err != nil || size == 0 {
+			continue
+		}
+
+		results = append(results, types.ScanResult{
+			Path:      path,
+			Type:      types.TypeHomebrew,
+			Size:      size,
+			FileCount: count,
+			Name:      target.Name,
+		})
+	}
+
+	return results
+}