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

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

machineconfig/setup_windows/__init__.py

@@ -1,11 +1,11 @@
 
 from pathlib import Path
 
-APPS = Path(__file__).parent.joinpath("apps.ps1")
 UV = Path(__file__).parent.joinpath("uv.ps1")
-
 DOCKER = Path(__file__).parent.joinpath("others/docker.ps1")
 OBS = Path(__file__).parent.joinpath("others/obs.ps1")
 POWER_OPTIONS = Path(__file__).parent.joinpath("others/power_options.ps1")
-
 SSH_SERVER = Path(__file__).parent.joinpath("ssh/openssh_server.ps1")
+INTERACTIVE = Path(__file__).parent.joinpath("web_shortcuts/interactive.ps1")
+LIVE = Path(__file__).parent.joinpath("web_shortcuts/live_from_github.ps1")
+

machineconfig/setup_windows/uv.ps1

@@ -7,4 +7,11 @@ if (-not (Test-Path -Path "$HOME\.local\bin\uv.exe")) {
     Write-Output "uv binary found, updating..."
     & "$HOME\.local\bin\uv.exe" self update
 }
-& "$HOME\.local\bin\uv.exe" python install 3.14
+
+# `C:\Users\aalsaf01\.local\bin` is not on your PATH. To use installed Python executables, run `$env:PATH = "C:\Users\aalsaf01\.local\bin;$env:PATH"` or `uv python update-shell`.
+& "$env:USERPROFILE\.local\bin\uv.exe" python update-shell
+$env:Path = [System.Environment]::GetEnvironmentVariable('Path', 'Machine') + ';' + [System.Environment]::GetEnvironmentVariable('Path', 'User')
+
+# & "$HOME\.local\bin\uv.exe" python install 3.14
+uv python install 3.14
+

machineconfig/setup_windows/web_shortcuts/interactive.ps1

@@ -1,15 +1,30 @@
 
 
 iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/uv.ps1").Content
-function mcfg {
-    & "$HOME\.local\bin\uv.exe" run --python 3.14 --with "machineconfig>=6.81" mcfg $args
-}
-function d { mcfg devops @args }
-function c { mcfg cloud @args }
-function a { mcfg agents @args }
-function ss { mcfg sessions @args }
-function ff { mcfg ftpx @args }
-function f { mcfg fire @args }
-function rr { mcfg croshell @args }
-function u { mcfg utils @args }
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/windows/wrap_mcfg.ps1").Content
+
+function devops   { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" devops $args }
+function cloud    { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" cloud $args }
+function agents   { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" agents $args }
+function sessions { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" sessions $args }
+function ftpx     { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" ftpx $args }
+function fire     { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" fire $args }
+function croshell { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" croshell $args }
+function utils    { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" utils $args }
+function terminal { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" terminal $args }
+function msearch  { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "machineconfig>=7.98" msearch $args }
+
+function d { wrap_in_shell_script devops @args }
+function c { wrap_in_shell_script cloud @args }
+function a { wrap_in_shell_script agents @args }
+function sx { wrap_in_shell_script sessions @args }
+function fx { wrap_in_shell_script ftpx @args }
+function f { wrap_in_shell_script fire @args }
+function rr { wrap_in_shell_script croshell @args }
+function u { wrap_in_shell_script utils @args }
+function t { wrap_in_shell_script terminal @args }
+function ms { wrap_in_shell_script msearch @args }
+
 Write-Host "mcfg command aliases are now defined in this PowerShell session."
+
+devops self interactive

machineconfig/setup_windows/web_shortcuts/live_from_github.ps1

@@ -0,0 +1,30 @@
+
+
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/uv.ps1").Content
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/windows/wrap_mcfg.ps1").Content
+
+function devops { & "$HOME\.local\bin\uvx.exe" --python 3.14 --from "git+https://github.com/thisismygitrepo/machineconfig" mcfg $args }
+
+function devops {mcfg devops @args }
+function cloud {mcfg cloud @args }
+function agents {mcfg agents @args }
+function sessions {mcfg sessions @args }
+function ftpx {mcfg ftpx @args }
+function fire {mcfg fire @args }
+function croshell {mcfg croshell @args }
+function utils {mcfg utils @args }
+function terminal {mcfg terminal @args }
+function msearch {mcfg msearch @args }
+
+function d { wrap_in_shell_script mcfg devops @args }
+function c { wrap_in_shell_script mcfg cloud @args }
+function a { wrap_in_shell_script mcfg agents @args }
+function sx { wrap_in_shell_script mcfg sessions @args }
+function fx { wrap_in_shell_script mcfg ftpx @args }
+function f { wrap_in_shell_script mcfg fire @args }
+function rr { wrap_in_shell_script mcfg croshell @args }
+function u { wrap_in_shell_script mcfg utils @args }
+function t { wrap_in_shell_script mcfg terminal @args }
+function ms { wrap_in_shell_script mcfg msearch @args }
+
+Write-Host "mcfg command aliases are now defined in this PowerShell session."

machineconfig/setup_windows/web_shortcuts/quick_init.ps1

@@ -0,0 +1,17 @@
+
+iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/uv.ps1").Content
+# iex (iwr "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/windows/wrap_mcfg.ps1").Content
+
+uv tool install --upgrade  --python 3.14 machineconfig
+
+devops install --group sysabc
+
+# configs
+devops config copy-assets both
+devops config public --method copy --on-conflict overwrite-default-path --which all
+devops config shell
+devops config shell --which nushell
+
+devops install --group termabc 
+wt  # start Windows Terminal to pick up config changes
+devops install --group gui

machineconfig/utils/accessories.py

@@ -1,4 +1,3 @@
-from pathlib import Path
 from typing import Optional, Any
 
 from datetime import datetime, timezone, timedelta
@@ -96,14 +95,18 @@ def human_friendly_dict(d: dict[str, Any]) -> dict[str, Any]:
     return result
 
 
-def get_repo_root(path: Path) -> Optional[Path]:
+def get_repo_root(path: "Path") -> Optional["Path"]:
     from git import Repo, InvalidGitRepositoryError
-
     try:
-        repo = Repo(str(path), search_parent_directories=True)
+        repo = Repo(path, search_parent_directories=True)
         root = repo.working_tree_dir
         if root is not None:
+            from pathlib import Path
             return Path(root)
     except InvalidGitRepositoryError:
         pass
     return None
+
+
+if __name__ == "__main__":
+    from pathlib import Path

machineconfig/utils/code.py

@@ -1,48 +1,78 @@
 
-from typing import Any, Optional, Callable
+from typing import Any, Literal, Optional, Callable, cast
 from machineconfig.utils.accessories import randstr
-from machineconfig.utils.meta import lambda_to_python_script
 from pathlib import Path
 
 
+def get_uv_run_command(platform: str) -> str:
+    res = cast(Literal["Windows", "windows", "nt", "Linux", "linux", "Darwin", "darwin", "macos"], platform)
+    match res:
+        case "Windows" | "windows" | "nt":
+            return """& "$env:USERPROFILE/.local/bin/uv" run"""
+        case "Linux" | "linux" | "Darwin" | "darwin" | "macos":
+            return """$HOME/.local/bin/uv run"""
+        case _:
+            return """$HOME/.local/bin/uv run"""
+
 def print_code(code: str, lexer: str, desc: str, subtitle: str = ""):
     import platform
-    from rich.console import Console
-    from rich.panel import Panel
-    from rich.syntax import Syntax
-    if lexer == "shell":
-        if platform.system() == "Windows":
-            lexer = "powershell"
-        elif platform.system() in ["Linux", "Darwin"]:
-            lexer = "sh"
-        else:
-            raise NotImplementedError(f"Platform {platform.system()} not supported for lexer {lexer}")
-    console = Console()
-    console.print(Panel(Syntax(code=code, lexer=lexer), title=f"📄 {desc}", subtitle=subtitle), style="bold red")
+    try:
+        from rich.console import Console
+        from rich.panel import Panel
+        from rich.syntax import Syntax
+        if lexer == "shell":
+            if platform.system() == "Windows":
+                lexer = "powershell"
+            elif platform.system() in ["Linux", "Darwin"]:
+                lexer = "sh"
+            else:
+                raise NotImplementedError(f"Platform {platform.system()} not supported for lexer {lexer}")
+        console = Console()
+        console.print(Panel(Syntax(code=code, lexer=lexer), title=f"📄 {desc}", subtitle=subtitle), style="bold red")
+    except ImportError:
+        print(f"--- {desc} ---")
+        print(code)
+        print(f"--- End of {desc} ---")
 
 
-def get_uv_command_executing_python_script(python_script: str, uv_with: Optional[list[str]], uv_project_dir: Optional[str]) -> tuple[str, Path]:
+def get_uv_command_executing_python_script(python_script: str, uv_with: Optional[list[str]], uv_project_dir: Optional[str],
+                                           prepend_print: bool = True) -> tuple[str, Path]:
     python_file = Path.home().joinpath("tmp_results", "tmp_scripts", "python", randstr() + ".py")
     python_file.parent.mkdir(parents=True, exist_ok=True)
     if uv_with is not None and len(uv_with) > 0:
-        uv_with.append("rich")
+        if prepend_print: uv_with.append("rich")
         uv_with_arg = "--with " + '"' + ",".join(uv_with) + '"'
     else:
-        uv_with_arg = "--with rich"
+        if prepend_print:
+            uv_with_arg = "--with rich"
+        else:
+            uv_with_arg = ""
     if uv_project_dir is not None:
         uv_project_dir_arg = "--project" + f' "{uv_project_dir}"'
     else:
         uv_project_dir_arg = ""
-    print_code_string = lambda_to_python_script(lambda: print_code(code=python_script, lexer="python", desc="Temporary Python Script", subtitle="Executing via shell script"), in_global=True, import_module=False)
-    python_file.write_text(print_code_string + "\n" + python_script, encoding="utf-8")
-    shell_script = f"""uv run {uv_with_arg} {uv_project_dir_arg}  {str(python_file)} """
+    
+    if prepend_print:
+        from machineconfig.utils.meta import lambda_to_python_script
+        print_code_string = lambda_to_python_script(lambda: print_code(code=python_script, lexer="python", desc="Temporary Python Script", subtitle="Executing via shell script"),
+                                                    in_global=True, import_module=False)
+        python_file.write_text(print_code_string + "\n" + python_script, encoding="utf-8")
+    else:
+        python_file.write_text(python_script, encoding="utf-8")
+    import platform
+    uv_run = get_uv_run_command(platform=platform.system())
+    shell_script = f"""{uv_run} {uv_with_arg} {uv_project_dir_arg}  {str(python_file)} """
     return shell_script, python_file
 
 
 def run_lambda_function(lmb: Callable[[], Any], uv_with: Optional[list[str]], uv_project_dir: Optional[str]) -> None:
-    code = lambda_to_python_script(lmb, in_global=True, import_module=False)
+    from machineconfig.utils.meta import lambda_to_python_script
+    code = lambda_to_python_script(lmb,
+                                            in_global=True, import_module=False)
     uv_command, _py_file = get_uv_command_executing_python_script(python_script=code, uv_with=uv_with, uv_project_dir=uv_project_dir)
     run_shell_script(uv_command)
+
+
 def run_python_script_in_marimo(py_script: str, uv_project_with: Optional[str]):
     tmp_dir = Path.home().joinpath("tmp_results", "tmp_scripts", "marimo", randstr())
     tmp_dir.mkdir(parents=True, exist_ok=True)
@@ -51,7 +81,7 @@ def run_python_script_in_marimo(py_script: str, uv_project_with: Optional[str]):
     if uv_project_with is not None:
         requirements = f"""--with "marimo" --project {uv_project_with} """
     else:
-        requirements = f"""--with "marimo" """
+        requirements = """--with "marimo" """
     fire_line = f"""
 cd {tmp_dir}
 uv run {requirements} marimo convert {pyfile.name} -o marimo_nb.py
@@ -77,38 +107,75 @@ def run_shell_script(script: str, display_script: bool = True, clean_env: bool =
         lexer = "bash"
     with tempfile.NamedTemporaryFile(mode='w', suffix=suffix, delete=False, encoding='utf-8') as temp_file:
         temp_file.write(script)
-        temp_script_path = Path(temp_file.name)
+        temp_shell_script_path = Path(temp_file.name)
     console = Console()
     if display_script:
         from rich.syntax import Syntax
-        console.print(Panel(Syntax(code=script, lexer=lexer), title=f"📄 shell script @ {temp_script_path}", subtitle="shell script being executed"), style="bold red")
+        console.print(Panel(Syntax(code=script, lexer=lexer), title=f"📄 shell script @ {temp_shell_script_path}", subtitle="shell script being executed"), style="bold red")
     env = {} if clean_env else None
     if platform.system() == "Windows":
         import subprocess
-        proc = subprocess.run(f'powershell -ExecutionPolicy Bypass -File "{temp_script_path}"', check=True, shell=True, env=env)
+        proc = subprocess.run(f'powershell -ExecutionPolicy Bypass -File "{temp_shell_script_path}"', check=True, shell=True, env=env)
     elif platform.system() == "Linux" or platform.system() == "Darwin":
         import subprocess
-        proc = subprocess.run(f"bash {str(temp_script_path)}", check=True, shell=True, env=env)
+        proc = subprocess.run(f"bash {str(temp_shell_script_path)}", check=True, shell=True, env=env)
     else:
         raise NotImplementedError(f"Platform {platform.system()} not supported.")
     # console.print(f"✅  [green]Script executed successfully:[/green] [blue]{temp_script_path}[/blue]")
     if proc.returncode != 0:
-        console.print(f"❌  [red]Script execution failed with return code {proc.returncode}:[/red] [blue]{temp_script_path}[/blue]")
+        console.print(f"❌  [red]Script execution failed with return code {proc.returncode}:[/red] [blue]{temp_shell_script_path}[/blue]")
     elif proc.returncode == 0:
-        console.print(f"✅  [green]Script executed successfully:[/green] [blue]{temp_script_path}[/blue]")
+        console.print(f"✅  [green]Script executed successfully:[/green] [blue]{temp_shell_script_path}[/blue]")
     else:
-        console.print(f"⚠️  [yellow]Script executed with warnings (return code {proc.returncode}):[/yellow] [blue]{temp_script_path}[/blue]")    
-    temp_script_path.unlink(missing_ok=True)
-    console.print(f"🗑️  [blue]Temporary script deleted:[/blue] [green]{temp_script_path}[/green]")
+        console.print(f"⚠️  [yellow]Script executed with warnings (return code {proc.returncode}):[/yellow] [blue]{temp_shell_script_path}[/blue]")
+    temp_shell_script_path.unlink(missing_ok=True)
+    console.print(f"🗑️  [blue]Temporary script deleted:[/blue] [green]{temp_shell_script_path}[/green]")
     return proc
 
 
-def exit_then_run_shell_script(script: str):
+def exit_then_run_shell_script(script: str, strict: bool = False):
     import os
+    from rich.console import Console
+    
+    console = Console()
     op_program_path = os.environ.get("OP_PROGRAM_PATH", None)
     if op_program_path is not None:
+        exists = Path(op_program_path).exists()
+    else:
+        exists = False
+    # three cases: (op_program_path is None, exists=False), (op_program_path is set, exists=False), (op_program_path is set, exists=True)
+
+    if strict:  # we want to assert op_program_path is set and is not an already existing file
+        if (op_program_path is None or exists):
+            import platform
+            if platform.system() == "Windows":
+                suffix = ".ps1"
+                lexer = "powershell"
+            else:
+                suffix = ".sh"
+                lexer = "bash"
+            op_program_path = Path.home().joinpath("tmp_results", "tmp_scripts", "manual_run", f"manual_script_{randstr()}{suffix}")
+            op_program_path.parent.mkdir(parents=True, exist_ok=True)
+            op_program_path.write_text(script, encoding="utf-8")
+            print_code(code=script, lexer=lexer, desc="script to run manually")
+            console.print("[bold yellow]⚠️  STRICT MODE:[/bold yellow] [cyan]Please run the script manually via your shell by executing:[/cyan]")
+            console.print(f"[green]{str(op_program_path)}[/green]")
+            console.print("[red]❌ OP_PROGRAM_PATH environment variable is not set in strict mode.[/red]")
+            import sys
+            sys.exit(1)
+
+    if op_program_path is not None and not exists:
         op_program_path = Path(op_program_path)
         op_program_path.parent.mkdir(parents=True, exist_ok=True)
         op_program_path.write_text(script, encoding="utf-8")
+        console.print("[cyan]🚀 Handing over to shell script runner via OP_PROGRAM_PATH:[/cyan]")
+        console.print(f"[bold green]{str(op_program_path)}[/bold green]")
+        print_code(code=script, lexer="shell", desc="script to run via OP_PROGRAM_PATH")
     else:
+        if op_program_path is not None and exists:
+            console.print(f"[yellow]⚠️  OP_PROGRAM_PATH @ {str(op_program_path)} already exists.[/yellow] [cyan]Falling back to direct execution.[/cyan]")
+        elif op_program_path is None:
+            console.print("[cyan]ℹ️  OP_PROGRAM_PATH is not set.[/cyan] [yellow]Falling back to direct execution.[/yellow]")
         run_shell_script(script)
+    import sys
+    sys.exit(0)

machineconfig/utils/files/ascii_art.py

@@ -62,7 +62,7 @@ def get_art(comment: Optional[str] = None, artlib: Optional[BOX_OR_CHAR] = None,
         try:
             comment = subprocess.run("fortune", shell=True, capture_output=True, text=True, check=True).stdout
         except Exception:
-            comment = "crocodile"
+            comment = "machineconfig"
     if artlib is None: artlib = random.choice(['boxes', 'cowsay'])
     to_file = '' if not file else f'> {file}'
     if artlib == 'boxes':

machineconfig/utils/files/headers.py

@@ -25,8 +25,9 @@ def print_header():
     table.add_row("Virtual Environment", os.getenv('VIRTUAL_ENV', 'None'))
     table.add_row("Running @", str(Path.cwd()))
 
+    from machineconfig.utils.installer_utils.installer_runner import get_machineconfig_version
 
-    console.print(Panel(table, title="[bold blue]✨ 🐊 Crocodile Shell 14.5 ✨ Made with 🐍 | Built with ❤️[/bold blue]", border_style="blue"))
+    console.print(Panel(table, title=f"[bold blue]✨ 🐊 Machineconfig Shell {get_machineconfig_version()} ✨ Made with 🐍 | Built with ❤️[/bold blue]", border_style="blue"))
 def print_logo(logo: str):
     from machineconfig.utils.files.ascii_art import font_box_color, character_color, character_or_box_color
     if platform.system() == "Windows":
@@ -43,7 +44,7 @@ def print_logo(logo: str):
             _default_art = Path(random.choice(glob.glob(str(Path(__file__).parent.joinpath("art", "*")))))
             print(_default_art.read_text())
     elif platform.system() in ["Linux", "Darwin"]:  # Explicitly handle both Linux and macOS
-        from machineconfig.utils.installer_utils.installer_abc import is_executable_in_path
+        from machineconfig.utils.installer_utils.installer_locator_utils import is_executable_in_path
         avail_cowsay = is_executable_in_path("cowsay")
         avail_lolcat = is_executable_in_path("lolcat")
         avail_boxes = is_executable_in_path("boxes")