machineconfig 3.7__py3-none-any.whl → 7.69__py3-none-any.whl

machineconfig/setup_linux/__init__.py

@@ -0,0 +1,10 @@
+
+from pathlib import Path
+
+INTERACTIVE = Path(__file__).parent.joinpath("web_shortcuts/interactive.sh")
+UV = Path(__file__).parent.joinpath("uv.sh")
+
+APPS_DESKTOP = Path(__file__).parent.joinpath("apps_desktop.sh")
+APPS_GUI = Path(__file__).parent.joinpath("apps_gui.sh")
+
+SSH_SERVER = Path(__file__).parent.joinpath("ssh/openssh_server.sh")

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/{nix → others}/cli_installation.sh

@@ -1,12 +1,8 @@
 #!/bin/bash
-#=======================================================================
 # 📦 NIX CLI TOOLS INSTALLATION SCRIPT
-#=======================================================================
 # This script installs various command-line utilities using the Nix package manager
 
-echo """#=======================================================================
-🔄 SYSTEM UTILITIES | Installing system management tools
-#=======================================================================
+echo """🔄 SYSTEM UTILITIES | Installing system management tools
 """
 
 # System upgrade tool
@@ -21,9 +17,7 @@ nix-env -iA nixpkgs.procs || true
 echo "📥 Installing watchexec - executes commands when files change..."
 nix-env -iA nixpkgs.watchexec || true
 
-echo """#=======================================================================
-📂 FILE MANAGEMENT | Installing file browsers and utilities
-#=======================================================================
+echo """📂 FILE MANAGEMENT | Installing file browsers and utilities
 """
 
 # Terminal file managers
@@ -56,9 +50,7 @@ nix-env -iA nixpkgs.diskonaut || true
 echo "📥 Installing kondo - cleanup tool for dev projects..."
 nix-env -iA nixpkgs.kondo || true
 
-echo """#=======================================================================
-🖼️ VISUAL TOOLS | Installing terminal visualization tools
-#=======================================================================
+echo """🖼️ VISUAL TOOLS | Installing terminal visualization tools
 """
 
 # Terminal visualization
@@ -71,9 +63,7 @@ nix-env -iA nixpkgs.bottom || true
 echo "📥 Installing delta - syntax-highlighting pager for git..."
 nix-env -iA nixpkgs.delta || true
 
-echo """#=======================================================================
-🔧 DEVELOPMENT TOOLS | Installing programming utilities
-#=======================================================================
+echo """🔧 DEVELOPMENT TOOLS | Installing programming utilities
 """
 
 # Code editors
@@ -95,9 +85,7 @@ nix-env -iA nixpkgs.tokei || true
 echo "📥 Installing gitui - terminal UI for git..."
 nix-env -iA nixpkgs.gitui || true
 
-echo """#=======================================================================
-🔎 SEARCH TOOLS | Installing fuzzy finders and search utilities
-#=======================================================================
+echo """🔎 SEARCH TOOLS | Installing fuzzy finders and search utilities
 """
 
 # Search history
@@ -108,9 +96,7 @@ nix-env -iA nixpkgs.mcfly || true
 echo "📥 Installing skim - fuzzy finder in Rust..."
 nix-env -iA nixpkgs.skim || true
 
-echo """#=======================================================================
-🌐 NETWORK & CLOUD TOOLS | Installing file transfer and cloud utilities
-#=======================================================================
+echo """🌐 NETWORK & CLOUD TOOLS | Installing file transfer and cloud utilities
 """
 
 # File transfer
@@ -121,18 +107,14 @@ nix-env -iA nixpkgs.termscp || true
 echo "📥 Installing rclone - rsync for cloud storage..."
 nix-env -iA nixpkgs.rclone || true
 
-echo """#=======================================================================
-🛡️ SECURITY TOOLS | Installing password management utilities
-#=======================================================================
+echo """🛡️ SECURITY TOOLS | Installing password management utilities
 """
 
 # Password management
 echo "📥 Installing gopass - team password manager with git..."
 nix-env -iA nixpkgs.gopass || true
 
-echo """#=======================================================================
-📚 DOCUMENTATION | Installing help and reference tools
-#=======================================================================
+echo """📚 DOCUMENTATION | Installing help and reference tools
 """
 
 # Command reference
@@ -143,9 +125,7 @@ nix-env -iA nixpkgs.tldr || true
 echo "📥 Installing nushell - modern shell alternative..."
 nix-env -iA nixpkgs.nushell || true
 
-echo """#=======================================================================
-✅ INSTALLATION COMPLETE | All Nix CLI tools have been installed
-#=======================================================================
+echo """✅ INSTALLATION COMPLETE | All Nix CLI tools have been installed
 """
 
 # Commented out tools

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,204 +1,29 @@
 #!/bin/bash
-
-echo """#=======================================================================
-📦 MACHINE CONFIGURATION | Interactive Installation Script
-#=======================================================================
-"""
-
-read -p "📥 Install Apps [y]/n? " choice
-
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    #=======================================================================
-    📦 APPLICATIONS | Installing base system applications
-    #=======================================================================
-    """
-    curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps.sh | bash
-else
-    echo """    ⏭️  Skipping applications installation
-    """
-fi
-
-echo """#=======================================================================
-🔄 SYSTEM UPDATE | Package management
-#=======================================================================
-"""
-read -p "🔄 Upgrade system packages [y]/n? " choice
-
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    📦 Upgrading system packages...
-    """
-    sudo nala upgrade -y
-else
-    echo """    ⏭️  Skipping system upgrade
-    """
-fi
-
-echo """#=======================================================================
-🐍 PYTHON ENVIRONMENT | Virtual environment setup
-#=======================================================================
-"""
-read -p "🐍 Install UV and repos [y]/n? " choice
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🔧 Setting up Python environment...
-    """
-    curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh | bash
-    curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/repos.sh | bash
-else
-    echo """    ⏭️  Skipping virtual environment setup
-    """
-fi
-
-
-echo """#=======================================================================
-🔒 SSH SERVER | Remote access setup
-#=======================================================================
-"""
-read -p "🔒 Install SSH Server [y]/n? " choice
-choice=${choice:-y}
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🔧 Installing SSH server...
-    """
-    sudo nala install openssh-server -y
-else
-    echo """    ⏭️  Skipping SSH server installation
-    """
-fi
-
-echo """#=======================================================================
-📂 DOTFILES MIGRATION | Configuration transfer options
-#=======================================================================
-
-🖱️  Method 1: USING MOUSE WITHOUT KB OR BROWSER SHARE
-    On original machine, run:
-    cd ~/dotfiles/creds/msc
-    easy-sharing . --password rew --username al
-    Then open brave on new machine to get MouseWithoutBorders password
-
-🔐 Method 2: USING SSH
-    FROM REMOTE, RUN:
-    fptx ~/dotfiles $USER@$(hostname):^ -z
-    # OR, using IP address if router has not yet found the hostname:
-    fptx ~/dotfiles $USER@$(hostname -I | awk '{print $1}'):^ -z
-
-☁️  Method 3: USING INTERNET SECURE SHARE
-    cd ~
-    cloud_copy SHARE_URL . --config ss
-    (requires symlinks to be created first)
-"""
-
-echo """#=======================================================================
-📂 DOTFILES STATUS | Configuration files check
-#=======================================================================
-"""
-read -p "📂 Have you finished copying dotfiles? [y]/n? " choice
-
-echo """#=======================================================================
-🔗 SYMLINK CREATION | Configuration setup
-#=======================================================================
-"""
-read -p "🔗 Create Symlinks (finish dotfiles transfer first) [y]/n? " choice
-choice=${choice:-y}
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🔧 Creating symlinks and setting permissions...
-    """
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.profile.create main --choice=all
-    sudo chmod 600 $HOME/.ssh/*
-    sudo chmod 700 $HOME/.ssh
-else
-    echo """    ⏭️  Skipping symlink creation
-    """
-fi
-
-echo """#=======================================================================
-⚡ CLI APPLICATIONS | Command-line tools installation
-#=======================================================================
-"""
-read -p "⚡ Install CLI Apps [y]/n? " choice
-choice=${choice:-y}
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🔧 Installing CLI applications...
-    """
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.scripts.python.devops_devapps_install main --which=AllEssentials
-    . $HOME/.bashrc
-else
-    echo """    ⏭️  Skipping CLI apps installation
-    """
-fi
-
-echo """#=======================================================================
-🛠️  DEVELOPMENT TOOLS | Software development packages
-#=======================================================================
-"""
-read -p "🛠️  Install Development Tools (rust, libssql-dev, ffmpeg, wezterm, brave, code) [y]/n? " choice
-choice=${choice:-y}
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🔧 Installing development tools... """
-    (curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh) || true
-    sudo nala install libssl-dev -y
-    sudo nala install ffmpeg -y
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.scripts.python.devops_devapps_install main --which=wezterm,brave,code
-else
-    echo """    ⏭️  Skipping development tools installation
-    """
-fi
-
-echo """#=======================================================================
-📚 REPOSITORIES | Project code retrieval
-#=======================================================================
-"""
-read -p "📚 Retrieve Repositories to ~/code [y]/n? " choice
-choice=${choice:-y}
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🔄 Cloning repositories...
-    """
-    repos ~/code --clone --cloud odg1
-else
-    echo """    ⏭️  Skipping repository retrieval
-    """
-fi
-
-echo """#=======================================================================
-💾 DATA RETRIEVAL | Backup restoration
-#=======================================================================
-"""
-read -p "💾 Retrieve Data [y]/n? " choice
-choice=${choice:-y}
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🔄 Retrieving data...
-    """
-    uv run --python 3.13 --with machineconfig python -m fire machineconfig.scripts.python.devops_backup_retrieve main --direction=RETRIEVE
-else
-    echo """    ⏭️  Skipping data retrieval
-    """
-fi
-
-echo """#=======================================================================
-🎨 ASCII ART | Terminal visualization tools
-#=======================================================================
-"""
-read -p "🎨 Install ASCII Art Libraries [y]/n? " choice
-choice=${choice:-y}
-if [[ "$choice" == "y" || "$choice" == "Y" ]]; then
-    echo """    🎨 Installing ASCII art libraries...
-    """
-    curl bit.ly/cfgasciiartlinux -L | sudo bash
-else
-    echo """    ⏭️  Skipping ASCII art installation
-    """
-fi
-
-# echo """# 📧 Thunderbird Setup Note:
-# Run after installing Thunderbird and starting it once:
-# cd ~/AppData/Roaming/ThunderBird/Profiles
-# \$res = ls
-# \$name = \$res[0].Name
-# mv \$backup_folder \$name
-# """
-
-echo """#=======================================================================
-✨ INSTALLATION COMPLETE | System setup finished successfully
-#=======================================================================
-
-🎉 Your system has been configured successfully!
-🔄 You may need to reboot to apply all changes.
-"""
+. <( 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 devops='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" devops'
+alias cloud='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" cloud'
+alias agents='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" agents'
+alias sessions='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" sessions'
+alias ftpx='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" ftpx'
+alias fire='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" fire'
+alias croshell='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" croshell'
+alias utils='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" utils'
+alias terminal='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" terminal'
+alias msearch='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.69" msearch'
+
+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_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"]