machineconfig 5.15__py3-none-any.whl → 7.98__py3-none-any.whl

machineconfig/setup_linux/apps_desktop.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/bash
+# 🖥️ DESKTOP APPLICATIONS INSTALLATION SCRIPT
+# This script installs desktop applications for a Linux workstation
+
+echo """🌐 WEB BROWSERS | Installing browser applications
+"""
+# Google Chrome installation (commented reference)
+# echo "📥 Installing Google Chrome..."
+# wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+# sudo dpkg -i google-chrome-stable_current_amd64.deb
+
+echo """📝 TEXT EDITORS | Installing Neovim editor
+"""
+echo "📥 Installing Neovim via Homebrew..."
+/home/linuxbrew/.linuxbrew/bin/brew install neovim
+
+echo """📧 EMAIL CLIENT | Installing Thunderbird
+"""
+echo "📥 Installing Thunderbird via Flatpak..."
+flatpak install flathub org.mozilla.Thunderbird
+
+echo """🖲️ TERMINAL EMULATOR | Installing WezTerm
+"""
+echo "📥 Installing WezTerm via Flatpak..."
+flatpak install flathub org.wezfurlong.wezterm
+echo "🚀 Launching WezTerm..."
+flatpak run org.wezfurlong.wezterm
+
+echo """✏️ SCREEN ANNOTATION | Installing Gromit-MPX
+"""
+echo "📥 Installing Gromit-MPX via Flatpak..."
+flatpak install net.christianbeier.Gromit-MPX
+
+echo """📋 CLIPBOARD MANAGERS | Installing CopyQ
+"""
+echo "📥 Installing CopyQ via Flatpak..."
+flatpak install flathub com.github.hluk.copyq --noninteractive
+
+echo """🔗 REMOTE DESKTOP | Installing Remmina
+"""
+echo "📥 Installing Remmina and RDP plugin..."
+sudo nala install remmina remmina-plugin-rdp -y
+
+# Alternative Remmina installation via flatpak (reference)
+# echo "📥 Setting up Flatpak repositories..."
+# flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+# flatpak install org.freedesktop.Platform
+# flatpak install org.freedesktop.Platform.openh264
+# flatpak install --user flathub org.remmina.Remmina
+# flatpak run --user org.remmina.Remmina
+
+echo """🚀 APPLICATION LAUNCHER | Installing Rofi
+"""
+echo "📥 Installing Rofi application launcher..."
+sudo nala install rofi -y
+
+echo """📎 CLIPBOARD HISTORY | Installing Greenclip
+"""
+# Session type detection (reference)
+# session_type=$(echo $XDG_SESSION_TYPE)
+# if [ "$session_type" == "x11" ]; then
+#     echo "Detected X11 session. Installing X11-related packages and tools..."
+#     sudo nala install xdotool xsel xclip -y
+# elif [ "$session_type" == "wayland" ]; then
+#     echo "Detected Wayland session. Installing Wayland-related packages and tools..."
+#     sudo nala install wl-copy wtype -y
+# else
+#     echo "Unknown session type: $session_type"
+#     exit 1
+# fi
+
+echo "📥 Downloading and installing Greenclip clipboard manager..."
+wget -P ~/Downloads https://github.com/erebe/greenclip/releases/download/v4.2/greenclip
+chmod +x ~/Downloads/greenclip
+sudo mv ~/Downloads/greenclip /usr/bin/
+
+echo "ℹ️ Usage instructions:"
+echo "- Start daemon: greenclip daemon &"
+echo "- With Rofi: rofi -modi \"clipboard:greenclip print\" -show clipboard -run-command '{cmd}'"
+echo "- For emoji picker: rofi -modi \"emoji:rofimoji\" -show emoji"
+echo "- Application launcher: rofi -show drun"
+
+echo """🔄 APPLICATION LINKING | Linking applications to user space
+"""
+echo "🔗 Creating application symlinks..."
+ln -s /home/$USER/.nix-profile/share/applications/* /home/$USER/.local/share/applications/
+
+echo """✅ INSTALLATION COMPLETE | Desktop applications have been installed
+"""

machineconfig/setup_linux/apps_gui.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+# 🖥️ GUI APPLICATIONS AND DESKTOP ENVIRONMENT SETUP SCRIPT
+# This script installs graphical user interfaces and desktop environments
+
+echo """📦 INSTALLING GUI COMPONENTS | Setting up desktop environment
+"""
+
+# echo "📥 Installing Nautilus file manager..."
+# sudo nala install nautilus -y  # 📂 graphical file manager
+# sudo nala install x11-apps  # 🎨 few graphical test apps like xeyes
+
+echo "📥 Installing XRDP - Remote Desktop Protocol server..."
+sudo nala install xrdp -y  # 🔌 remote desktop protocol
+
+# echo "📥 Installing X.Org server and components..."
+# sudo nala install xorg -y  # 🎯 xorg server
+# sudo nala install xinit -y  # 🚀 xorg init
+# sudo nala install xserver-xorg -y  # 🖼️ xorg server
+
+echo "📥 Installing XFCE4 desktop environment..."
+sudo nala install xfce4 -y  # 🏠 xfce4 desktop environment
+
+echo "📥 Installing XFCE4 additional components..."
+sudo nala install xfce4-goodies -y  # ✨ xfce4 desktop environment extras
+
+echo """🔧 CONFIGURING XRDP | Setting up Remote Desktop service
+"""
+
+# Back up original configuration
+echo "📄 Creating backup of XRDP configuration..."
+sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak
+
+# Change default port to avoid conflict with Windows RDP
+echo "🔢 Changing XRDP port to 3391..."
+sudo sed -i 's/3389/3391/g' /etc/xrdp/xrdp.ini
+
+# Configure color depth and display settings
+echo "🎨 Configuring display quality settings..."
+sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini
+sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini
+
+# Set default session
+echo "🖥️ Setting up default XFCE4 session..."
+echo xfce4-session > ~/.xsession
+
+# Configure startup window manager
+echo "🚀 Configuring window manager startup..."
+sudo sed -i 's/test/#test/g' /etc/xrdp/startwm.sh
+sudo sed -i 's/exec/#exec/g' /etc/xrdp/startwm.sh
+echo "startxfce4" | sudo tee -a /etc/xrdp/startwm.sh
+
+echo """🚀 STARTING SERVICES | Initializing XRDP service
+"""
+
+echo "🔄 Starting XRDP service..."
+sudo /etc/init.d/xrdp start
+
+echo """✅ SETUP COMPLETE | GUI environment has been configured
+"""
+echo "ℹ️ Connect to this machine via Remote Desktop using port 3391"
+# Alternative commands:
+# sudo systemctl restart xrdp
+# sudo service xrdp restart
+

machineconfig/setup_linux/ssh/openssh_all.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/bash
+# 🔐 OpenSSH Server Setup and Configuration
+
+# Common pitfalls: 
+# 🚫 Wrong line endings (LF/CRLF) in config files
+# 🌐 Network port conflicts (try 2222 -> 2223) between WSL and Windows
+
+# 📁 Setup SSH directory and permissions
+mkdir -p ~/.ssh
+echo $pubkey_string >> ~/.ssh/authorized_keys
+sudo chmod 600 ~/.ssh/*
+sudo chmod 700 ~/.ssh
+echo "✅ FINISHED modifying .ssh folder attributes."
+
+# 🔄 Clean install OpenSSH server
+sudo nala install openssh-server -y || true  # try to install first
+sudo nala purge openssh-server -y
+sudo nala install openssh-server -y
+echo "✅ FINISHED installing openssh-server."
+
+# 📝 Additional commands if needed:
+# sudo service ssh status
+# sudo nano /etc/ssh/sshd_config
+# sudo service ssh restart
+# For tunnels see: https://www.youtube.com/watch?v=Wp7boqm3Xts

machineconfig/setup_linux/ssh/openssh_wsl.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/bash
+# 🐧 WSL2 SSH Configuration for LAN Access 🌐
+# Purpose: Enable SSH access to WSL2 from LAN (requires wsl_server.ps1 in Windows)
+# Common pitfall: sshd fails after config changes due to wrong line endings/permissions
+
+# 🔍 Check if running in WSL
+if [[ $(uname -a) == *"icrosoft"* ]]; then
+  echo "✅ Running inside WSL"
+else
+  echo "❌ Not running inside WSL, no need for this script"
+  exit 0
+fi
+
+# 🔢 Set SSH port
+if [ -z "$port" ]; then
+  port=2222
+  echo "📝 Port variable not defined, setting it to $port"
+fi
+
+# 🛠️ Configure SSH
+sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
+sudo sed -i 's/#Port 22/Port '$port'/g' /etc/ssh/sshd_config
+sudo sed -i 's/#ListenAddress 0.0.0.0/ListenAddress 0.0.0.0/g' /etc/ssh/sshd_config
+sudo sed -i 's/#PubkeyAuthentication yes/PubkeyAuthentication yes/g' /etc/ssh/sshd_config
+sudo sed -i 's/PasswordAuthentication no/PasswordAuthentication yes/g' /etc/ssh/sshd_config
+
+# 🔑 Generate host keys and restart service
+sudo service ssh start
+sudo ssh-keygen -A
+sudo service ssh --full-restart
+sudo service ssh status
+
+echo "✨ FINISHED configuring SSH in WSL2."
+
+# 📚 References:
+# Service startup: https://superuser.com/questions/1701853/how-to-enable-a-service-to-start-with-wsl2
+# WSL config: https://learn.microsoft.com/en-us/windows/wsl/networking#accessing-a-wsl-2-distribution-from-your-local-area-network-lan
+

machineconfig/setup_linux/uv.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/bash
+
+if [ ! -f "$HOME/.local/bin/uv" ]; then
+    echo """📦 uv binary not found
+   ⏳ Installing uv package manager..."""
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+else
+    echo """🔄 Updating uv package manager..."""
+    $HOME/.local/bin/uv self update
+fi
+if ! command -v uv &> /dev/null; then
+    echo """🔍 uv command not found in PATH ➕ Adding uv to system PATH..."""
+    export PATH="$HOME/.local/bin:$PATH"
+fi
+$HOME/.local/bin/uv python install 3.14

machineconfig/setup_linux/web_shortcuts/interactive.sh

@@ -1,9 +1,29 @@
 #!/bin/bash
+. <( curl -sSL "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/uv.sh")
+. <( curl -sSL "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/linux/wrap_mcfg")
 
-echo """
-=======================================================================
-📦 MACHINE CONFIGURATION | Interactive Installation Script. Installing uv then getting started.
-======================================================================="""
+alias devops='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" devops'
+alias cloud='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" cloud'
+alias agents='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" agents'
+alias sessions='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" sessions'
+alias ftpx='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" ftpx'
+alias fire='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" fire'
+alias croshell='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" croshell'
+alias utils='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" utils'
+alias terminal='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" terminal'
+alias msearch='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.98" msearch'
 
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh | bash
-$HOME/.local/bin/uv run --python 3.13 --with machineconfig devops interactive
+alias d='wrap_in_shell_script devops'
+alias c='wrap_in_shell_script cloud'
+alias a='wrap_in_shell_script agents'
+alias ss='wrap_in_shell_script sessions'
+alias fx='wrap_in_shell_script ftpx'
+alias f='wrap_in_shell_script fire'
+alias rr='wrap_in_shell_script croshell'
+alias u='wrap_in_shell_script utils'
+alias t='wrap_in_shell_script terminal'
+alias ms='wrap_in_shell_script msearch'
+
+echo "mcfg command aliases are now defined in this shell session."
+
+devops self interactive

machineconfig/setup_linux/web_shortcuts/live_from_github.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+. <( curl -sSL "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/uv.sh")
+. <( curl -sSL "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/linux/wrap_mcfg")
+
+alias mcfg='$HOME/.local/bin/uvx --python 3.14 --from "git+https://github.com/thisismygitrepo/machineconfig" mcfg'
+
+alias d='wrap_in_shell_script mcfg devops'
+alias c='wrap_in_shell_script mcfg cloud'
+alias a='wrap_in_shell_script mcfg agents'
+alias ss='wrap_in_shell_script mcfg sessions'
+alias fx='wrap_in_shell_script mcfg ftpx'
+alias f='wrap_in_shell_script mcfg fire'
+alias rr='wrap_in_shell_script mcfg croshell'
+alias u='wrap_in_shell_script mcfg utils'
+alias t='wrap_in_shell_script mcfg terminal'
+alias ms='wrap_in_shell_script mcfg msearch'
+
+alias devops='mcfg devops'
+alias cloud='mcfg cloud'
+alias agents='mcfg agents'
+alias sessions='mcfg sessions'
+alias ftpx='mcfg ftpx'
+alias fire='mcfg fire'
+alias croshell='mcfg croshell'
+alias utils='mcfg utils'
+alias terminal='mcfg terminal'
+alias msearch='mcfg msearch'
+
+
+echo "mcfg command aliases are now defined in this shell session."
+

machineconfig/setup_mac/__init__.py

@@ -0,0 +1,16 @@
+"""Mac setup module for machineconfig.
+
+This module provides setup script locations and configurations for macOS systems.
+It mirrors the layout used by the Linux setup module and exposes Path objects
+pointing at common scripts (so other code can import these paths).
+"""
+
+from pathlib import Path
+
+
+# Optional helper scripts (may or may not exist)
+UV = Path(__file__).parent.joinpath("uv.sh")
+# Path to macOS SSH helper
+SSH_SETUP = Path(__file__).parent.joinpath("ssh/openssh_setup.sh")
+
+__all__ = ["UV", "SSH_SETUP"]

machineconfig/setup_mac/apps_gui.sh

@@ -0,0 +1,248 @@
+#!/usr/bin/env bash
+
+# macOS GUI Application Installation Script
+# Comprehensive GUI application installation via Homebrew Cask and Mac App Store
+# Supports Intel and Apple Silicon architectures
+
+set -e  # Exit on any error
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Logging functions
+log_info() {
+    echo -e "${BLUE}ℹ️  $1${NC}"
+}
+
+log_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+log_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+log_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+# Architecture detection
+detect_architecture() {
+    local arch=$(uname -m)
+    if [[ "$arch" == "arm64" ]]; then
+        echo "arm64"
+    elif [[ "$arch" == "x86_64" ]]; then
+        echo "amd64"
+    else
+        log_warning "Unknown architecture: $arch, defaulting to amd64"
+        echo "amd64"
+    fi
+}
+
+# Check if Homebrew is installed
+check_homebrew() {
+    if ! command -v brew &> /dev/null; then
+        log_error "Homebrew is not installed. Please run apps.sh first to install Homebrew."
+        exit 1
+    fi
+    log_success "Homebrew found"
+}
+
+# Setup Mac App Store CLI
+setup_mas() {
+    log_info "Setting up Mac App Store CLI (mas)..."
+    
+    if ! command -v mas &> /dev/null; then
+        log_info "Installing mas (Mac App Store CLI)..."
+        brew install mas || {
+            log_error "Failed to install mas"
+            return 1
+        }
+    else
+        log_success "mas already installed"
+    fi
+    
+    # Check if user is signed in to Mac App Store
+    if ! mas account &> /dev/null; then
+        log_warning "Not signed in to Mac App Store. Some applications may not install."
+        log_info "Please sign in to the Mac App Store manually to install App Store applications."
+    else
+        log_success "Signed in to Mac App Store"
+    fi
+}
+
+# Install a GUI application with error handling
+install_gui_app() {
+    local app_name="$1"
+    local description="$2"
+    local install_cmd="$3"
+    local fallback_cmd="$4"
+    
+    log_info "Installing $description..."
+    
+    if eval "$install_cmd"; then
+        log_success "$app_name installed successfully"
+        return 0
+    elif [[ -n "$fallback_cmd" ]]; then
+        log_warning "Primary installation failed, trying fallback method..."
+        if eval "$fallback_cmd"; then
+            log_success "$app_name installed via fallback method"
+            return 0
+        else
+            log_error "Failed to install $app_name via fallback method"
+            return 1
+        fi
+    else
+        log_error "Failed to install $app_name"
+        return 1
+    fi
+}
+
+# Install GUI applications from a list
+install_gui_app_list() {
+    local group_name="$1"
+    shift
+    local apps=("$@")
+    
+    log_info "Installing $group_name applications..."
+    
+    local failed_apps=()
+    for app_info in "${apps[@]}"; do
+        IFS='|' read -r app_name description install_cmd fallback_cmd <<< "$app_info"
+        if ! install_gui_app "$app_name" "$description" "$install_cmd" "$fallback_cmd"; then
+            failed_apps+=("$app_name")
+        fi
+    done
+    
+    if [[ ${#failed_apps[@]} -gt 0 ]]; then
+        log_warning "$group_name: Failed to install: ${failed_apps[*]}"
+    else
+        log_success "All $group_name applications installed successfully"
+    fi
+}
+
+# Main installation function
+main() {
+    log_info "Starting macOS GUI application installation..."
+    log_info "Detected architecture: $(detect_architecture)"
+    
+    # Check prerequisites
+    check_homebrew
+    setup_mas
+    
+    # --GROUP:BROWSERS - Web browsers
+    local browsers=(
+        "brave-browser|Brave Browser - Privacy-focused web browser|brew install --cask brave-browser|"
+        "google-chrome|Google Chrome web browser|brew install --cask google-chrome|"
+        "firefox|Mozilla Firefox web browser|brew install --cask firefox|"
+        "microsoft-edge|Microsoft Edge web browser|brew install --cask microsoft-edge|"
+        "safari-technology-preview|Safari Technology Preview|brew install --cask safari-technology-preview|"
+    )
+    
+    install_gui_app_list "Browsers" "${browsers[@]}"
+    
+    # --GROUP:CODE_EDITORS - Code editors and IDEs
+    local code_editors=(
+        "visual-studio-code|Visual Studio Code|brew install --cask visual-studio-code|"
+        "cursor|Cursor AI-powered code editor|brew install --cask cursor|"
+        "sublime-text|Sublime Text editor|brew install --cask sublime-text|"
+        "atom|Atom text editor|brew install --cask atom|"
+        "webstorm|JetBrains WebStorm IDE|brew install --cask webstorm|"
+        "pycharm|JetBrains PyCharm IDE|brew install --cask pycharm|"
+        "intellij-idea|JetBrains IntelliJ IDEA|brew install --cask intellij-idea|"
+        "xcode|Xcode development environment|mas install 497799835|brew install --cask xcode"
+    )
+    
+    install_gui_app_list "Code Editors & IDEs" "${code_editors[@]}"
+    
+    # --GROUP:PRODUCTIVITY - Productivity and office applications
+    local productivity=(
+        "obsidian|Obsidian note-taking app|brew install --cask obsidian|"
+        "notion|Notion workspace|brew install --cask notion|"
+        "bitwarden|Bitwarden password manager|brew install --cask bitwarden|"
+        "1password|1Password password manager|brew install --cask 1password|mas install 1333542190"
+        "alfred|Alfred productivity app|brew install --cask alfred|"
+        "raycast|Raycast launcher and productivity tool|brew install --cask raycast|"
+        "rectangle|Rectangle window management|brew install --cask rectangle|"
+        "magnet|Magnet window manager|mas install 441258766|brew install --cask magnet"
+        "cleanmymac|CleanMyMac X system cleaner|mas install 1339170533|"
+    )
+    
+    install_gui_app_list "Productivity" "${productivity[@]}"
+    
+    # --GROUP:MEDIA - Media and entertainment applications
+    local media=(
+        "vlc|VLC media player|brew install --cask vlc|"
+        "obs|OBS Studio for streaming and recording|brew install --cask obs|"
+        "handbrake|HandBrake video transcoder|brew install --cask handbrake|"
+        "spotify|Spotify music streaming|brew install --cask spotify|mas install 324684580"
+        "youtube-music|YouTube Music|brew install --cask youtube-music|"
+        "plex|Plex media server|brew install --cask plex|"
+        "keka|Keka archive utility|brew install --cask keka|mas install 470158793"
+        "the-unarchiver|The Unarchiver|brew install --cask the-unarchiver|mas install 425424353"
+    )
+    
+    install_gui_app_list "Media & Entertainment" "${media[@]}"
+    
+    # --GROUP:DEVELOPMENT - Development and system tools
+    local development=(
+        "docker|Docker Desktop|brew install --cask docker|"
+        "postman|Postman API development|brew install --cask postman|"
+        "insomnia|Insomnia REST client|brew install --cask insomnia|"
+        "github-desktop|GitHub Desktop|brew install --cask github-desktop|"
+        "sourcetree|Sourcetree Git client|brew install --cask sourcetree|"
+        "iterm2|iTerm2 terminal emulator|brew install --cask iterm2|"
+        "warp|Warp modern terminal|brew install --cask warp|"
+        "alacritty|Alacritty terminal emulator|brew install --cask alacritty|"
+    )
+    
+    install_gui_app_list "Development Tools" "${development[@]}"
+    
+    # --GROUP:DATABASE - Database management tools
+    local database=(
+        "dbeaver-community|DBeaver database tool|brew install --cask dbeaver-community|"
+        "sequel-pro|Sequel Pro MySQL client|brew install --cask sequel-pro|"
+        "tableplus|TablePlus database client|brew install --cask tableplus|"
+        "redis-insight|RedisInsight Redis GUI|brew install --cask redisinsight|"
+        "mongodb-compass|MongoDB Compass|brew install --cask mongodb-compass|"
+    )
+    
+    install_gui_app_list "Database Tools" "${database[@]}"
+    
+    # --GROUP:COMMUNICATION - Communication and collaboration
+    local communication=(
+        "slack|Slack team communication|brew install --cask slack|mas install 803453959"
+        "discord|Discord voice and text chat|brew install --cask discord|"
+        "zoom|Zoom video conferencing|brew install --cask zoom|"
+        "microsoft-teams|Microsoft Teams|brew install --cask microsoft-teams|"
+        "whatsapp|WhatsApp Desktop|brew install --cask whatsapp|mas install 1147396723"
+        "telegram|Telegram messaging|brew install --cask telegram|mas install 747648890"
+    )
+    
+    install_gui_app_list "Communication" "${communication[@]}"
+    
+    # --GROUP:SYSTEM_UTILITIES - System utilities and maintenance
+    local system_utilities=(
+        "appcleaner|AppCleaner uninstaller|brew install --cask appcleaner|"
+        "coconutbattery|CoconutBattery system info|brew install --cask coconutbattery|"
+        "disk-utility|Disk Utility (built-in)|echo 'Disk Utility is built into macOS'|"
+        "activity-monitor|Activity Monitor (built-in)|echo 'Activity Monitor is built into macOS'|"
+        "finder|Finder (built-in)|echo 'Finder is built into macOS'|"
+        "homebrew|Homebrew package manager|echo 'Homebrew already installed'|"
+    )
+    
+    install_gui_app_list "System Utilities" "${system_utilities[@]}"
+    
+    log_success "macOS GUI application installation completed!"
+    log_info "Some applications may require additional setup or signing in to your accounts."
+    log_info "Check Applications folder for newly installed apps."
+}
+
+# Execute main function if script is run directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi