Adds inline docs to Brewfile

installs/.Brewfile

@@ -21,44 +21,45 @@ brew 'ranger'
 brew 'tmux'
 
 # CLI Utils
-brew 'ctags'
+brew 'ctags'        # Indexing of file info + headers
-brew 'exa'
+brew 'exa'          # Better ls
-brew 'fzf'
+brew 'fzf'          # Fuzzy file finder
-brew 'glances'
+brew 'glances'      # top app, with web interface + API
-brew 'gotop'
+brew 'gotop'        # Better htop app, resource monitoring
-brew 'iproute2mac'
+brew 'iproute2mac'  # MacOS port of netstat and ifconfig
-brew 'jq'
+brew 'jq'           # JSON parser
-brew 'lazydocker'
+brew 'lazydocker'   # CLI Docker management app
-brew 'scc'
+brew 'scc'          # Code counter, like cloc
-brew 'tldr'
+brew 'tldr'         # Community-maintained man pages
-brew 'tree'
+brew 'tree'         # Directory listings as tree
-brew 'xsel'
+brew 'xsel'         # Copy paste access to X clipboard
 
 # CLI Fun
-brew 'figlet'
+brew 'figlet'       # Output text as ASCII art
-brew 'lolcat'
+brew 'lolcat'       # Make output raibow colored
-brew 'neofetch'
+brew 'neofetch'     # Show system and ditstro info
 
 # Development
-cask 'android-studio'
+cask 'android-studio' # IDE for Android development
-cask 'boop'
+cask 'boop'           # Test transformation tool
-brew 'gradle'
+brew 'gradle'         # Build automation for Java
-# brew 'qemu'
+# brew 'qemu'         # Machine emulator + virtualizer
-cask 'iterm2'
+cask 'iterm2'         # Better terminal emulator
-cask 'postman'
+cask 'postman'        # HTTP API testing app
-cask 'sourcetree'
+cask 'sourcetree'     # Git visual client
-cask 'utm'
+cask 'utm'            # VM management console
-cask 'visual-studio-code'
+cask 'visual-studio-code' # Code editor
 
 # Development Utils
-brew 'gh'
+brew 'gh'     # Interact with GitHub PRs, issues, repos
-cask 'ngrok'
+cask 'ngrok'  # Reverse proxy for development / testing
 
 # Languages and Compilers
 brew 'docker'
 brew 'gcc'
 brew 'go'
 brew 'lua'
+brew 'luarocks'
 brew 'node'
 brew 'nvm' 
 brew 'openjdk'
@@ -67,18 +68,18 @@ brew 'rust'
 cask 'android-sdk'
 
 # Network and Security Testing
-brew 'nmap'
+brew 'nmap'       # Port scanning
-brew 'wrk'
+brew 'wrk'        # HTTP benchmarking
-cask 'burp-suite'
+cask 'burp-suite' # Web security testing
-cask 'metasploit'
+cask 'metasploit' # Pen testing framework
-cask 'owasp-zap'
+cask 'owasp-zap'  # Web app security scanner
-cask 'wireshark'
+cask 'wireshark'  # Network analyzer + packet capture
 
 # Security Utilities
-brew 'bcrypt'
+brew 'bcrypt'     # Encryption utility, using blowfish
-cask 'gpg-suite'
+cask 'gpg-suite'  # PGP encryption for emails and files
-brew 'openssl'
+brew 'openssl'    # Cryptography and SSL/TLS Toolkit
-cask 'veracrypt'
+cask 'veracrypt'  # File and volume encryption
 
 # Fonts
 tap 'homebrew/cask-fonts'
@@ -88,36 +89,37 @@ cask 'font-inconsolata'
 cask 'font-meslo-lg-nerd-font'
 
 # Mac OS Mods and Imrovments
-brew 'm-cli'
+brew 'm-cli'          # All in one MacOS management CLI app
-cask 'alt-tab'
+cask 'alt-tab'        # Much better alt-tab window switcher
-cask 'anybar'
+cask 'anybar'         # Custom programatic menubar icons
-cask 'coteditor'
+cask 'coteditor'      # Just a simple plain-text editor
-cask 'finicky'
+cask 'finicky'        # Website-specific default browser
-cask 'hiddenbar'
+cask 'hiddenbar'      # Hide / show annoying menubar icons
-cask 'linearmouse'
+cask 'linearmouse'    # Device-specific mouse preferences
-cask 'little-snitch'
+cask 'little-snitch'  # Firewall GUI for blocking traffic
-cask 'stats'
+cask 'mjolnir'        # Util for loading Lua automations
+cask 'stats'          # System resource usage in menubar
 
 # Productivity Utils
-cask 'copyq'
+cask 'copyq'          # Clipboard manager
 tap 'espanso/espanso'
-cask 'espanso'
+cask 'espanso'        # Text expander
 
 # Media and Creativity
-brew 'handbrake'
+brew 'handbrake'      # Video transcoder
-cask 'audacity'
+cask 'audacity'       # Audio editor / recorder
-cask 'gimp'
+cask 'gimp'           # Photo editor
-cask 'inkscape'
+cask 'inkscape'       # Vector editor
-cask 'obs'
+cask 'obs'            # Screencasting / recording
-cask 'shotcut'
+cask 'shotcut'        # Video editor
-cask 'spotify', args: { require_sha: false }
+cask 'spotify', args: { require_sha: false } # Propietary music streaming
-cask 'transmission'
+cask 'transmission'   # Torrent client
-cask 'vlc'
+cask 'vlc'            # Media player
 
 # General Applications
-cask '1password'
+cask '1password'      # Password manager (proprietary)
-cask 'tresorit'
+cask 'tresorit'       # Encrypted file backup (proprietary)
-cask 'firefox'
+cask 'firefox'        # Browser
-cask 'chromium'
+cask 'chromium'       # Browser, again
-cask 'standard-notes'
+cask 'standard-notes' # Encrypted synced notes
-cask 'signal'
+cask 'signal'         # Messenger