machineconfig 5.24__py3-none-any.whl → 5.26__py3-none-any.whl

machineconfig/jobs/installer/custom/hx.py

@@ -77,7 +77,7 @@ def main(version: Optional[str], install_lib: bool = False):
     print(f"   ✨ Cleaned '{runtime_path}' and '{contrib_path}'.")
 
     print("\n📦 [Step 4/5] Installing Helix components...")
-    target_config_dir = PathExtended("~/.config/helix").expanduser()
+    target_config_dir = PathExtended.home().joinpath(".config/helix").expanduser()
     target_config_dir.mkdir(parents=True, exist_ok=True)
 
     if platform.system() in ["Linux", "Darwin"]:

machineconfig/jobs/installer/custom_dev/alacritty.py

@@ -30,8 +30,8 @@ def main(installer_data: InstallerData, version: Optional[str]) -> None:
         program = """
 
 cargo install alacritty
-mkdir -p ~/.config/alacritty/themes
-git clone https://github.com/alacritty/alacritty-theme ~/.config/alacritty/themes
+mkdir -p $HOME/.config/alacritty/themes
+git clone https://github.com/alacritty/alacritty-theme $HOME/.config/alacritty/themes
 
 """
     elif platform.system() in ["Linux", "Darwin"]:
@@ -41,8 +41,8 @@ git clone https://github.com/alacritty/alacritty-theme ~/.config/alacritty/theme
 
 
 cargo install alacritty
-mkdir -p ~/.config/alacritty/themes
-git clone https://github.com/alacritty/alacritty-theme ~/.config/alacritty/themes
+mkdir -p $HOME/.config/alacritty/themes
+git clone https://github.com/alacritty/alacritty-theme $HOME/.config/alacritty/themes
 
 """
     else:

machineconfig/jobs/installer/linux_scripts/wezterm.sh

@@ -36,5 +36,5 @@ echo """#=======================================================================
 #=======================================================================
 """
 echo "🚀 You can now launch WezTerm from your applications menu or by typing 'wezterm' in terminal"
-echo "💡 Configure WezTerm by editing ~/.config/wezterm/wezterm.lua"
+echo "💡 Configure WezTerm by editing $HOME/.config/wezterm/wezterm.lua"
 echo "🔗 For more information and configuration options, visit: https://wezfurlong.org/wezterm/"

machineconfig/scripts/python/agents.py

@@ -5,7 +5,7 @@
 from pathlib import Path
 from typing import cast, Iterable, Optional, get_args
 import typer
-from machineconfig.scripts.python.fire_agents_helper_types import AGENTS
+from machineconfig.scripts.python.helpers_fire.fire_agents_helper_types import AGENTS
 
 
 def _write_list_file(target: Path, files: Iterable[Path]) -> None:
@@ -28,9 +28,9 @@ def create(
     agents_dir: Optional[Path] = typer.Option(None, help="Directory to store agent files. If not provided, will be constructed automatically."),
 ):
 
-    from machineconfig.scripts.python.fire_agents_help_launch import prep_agent_launch, get_agents_launch_layout
-    from machineconfig.scripts.python.fire_agents_help_search import search_files_by_pattern, search_python_files
-    from machineconfig.scripts.python.fire_agents_load_balancer import chunk_prompts
+    from machineconfig.scripts.python.helpers_fire.fire_agents_help_launch import prep_agent_launch, get_agents_launch_layout
+    from machineconfig.scripts.python.helpers_fire.fire_agents_help_search import search_files_by_pattern, search_python_files
+    from machineconfig.scripts.python.helpers_fire.fire_agents_load_balancer import chunk_prompts
     from machineconfig.utils.accessories import get_repo_root, randstr
     import json
 

machineconfig/scripts/python/choose_wezterm_theme.py

@@ -52,14 +52,14 @@ def main2():
 
 def set_theme(theme: str):
     print(f"🔄 Setting WezTerm theme to: {theme}")
-    txt_lines = PathExtended("~/.config/wezterm/wezterm.lua").expanduser().read_text(encoding="utf-8").splitlines()
+    txt_lines = PathExtended.home().joinpath(".config/wezterm/wezterm.lua").expanduser().read_text(encoding="utf-8").splitlines()
     res_lines = []
     for line in txt_lines:
         if "config.color_scheme = " in line:
             res_lines.append(f"config.color_scheme = '{theme}'")
         else:
             res_lines.append(line)
-    PathExtended("~/.config/wezterm/wezterm.lua").expanduser().write_text("\n".join(res_lines), encoding="utf-8")
+    PathExtended.home().joinpath(".config/wezterm/wezterm.lua").expanduser().write_text("\n".join(res_lines), encoding="utf-8")
     time.sleep(0.1)
     print("💾 Configuration saved")
 

machineconfig/scripts/python/devops.py

@@ -34,7 +34,7 @@ app.add_typer(self_app, name="self")
 @self_app.command()
 def update():
     """🔄 UPDATE essential repos"""
-    import machineconfig.scripts.python.devops_update_repos as helper
+    import machineconfig.scripts.python.devops_helpers.devops_update_repos as helper
     helper.main()
 @self_app.command()
 def interactive():
@@ -44,7 +44,7 @@ def interactive():
 @self_app.command()
 def status():
     """📊 STATUS of machine, shell profile, apps, symlinks, dotfiles, etc."""
-    import machineconfig.scripts.python.devops_status as helper
+    import machineconfig.scripts.python.devops_helpers.devops_status as helper
     helper.main()
 @self_app.command()
 def clone():
@@ -100,12 +100,12 @@ def shell(method: Annotated[Literal["copy", "reference"], typer.Argument(help="C
 @nw_apps.command()
 def add_key():
     """🔑 SSH add pub key to this machine"""
-    import machineconfig.scripts.python.devops_add_ssh_key as helper
+    import machineconfig.scripts.python.devops_helpers.devops_add_ssh_key as helper
     helper.main()
 @nw_apps.command()
 def add_identity():
     """🗝️ SSH add identity (private key) to this machine"""
-    import machineconfig.scripts.python.devops_add_identity as helper
+    import machineconfig.scripts.python.devops_helpers.devops_add_identity as helper
     helper.main()
 @nw_apps.command()
 def connect():
@@ -131,14 +131,14 @@ def setup():
 @app_data.command()
 def backup():
     """💾 BACKUP"""
-    from machineconfig.scripts.python.devops_backup_retrieve import main_backup_retrieve
+    from machineconfig.scripts.python.devops_helpers.devops_backup_retrieve import main_backup_retrieve
     main_backup_retrieve(direction="BACKUP")
 
 
 @app_data.command()
 def retrieve():
     """📥 RETRIEVE"""
-    from machineconfig.scripts.python.devops_backup_retrieve import main_backup_retrieve
+    from machineconfig.scripts.python.devops_helpers.devops_backup_retrieve import main_backup_retrieve
     main_backup_retrieve(direction="RETRIEVE")
 
 

machineconfig/scripts/python/{devops_update_repos.py → devops_helpers/devops_update_repos.py}

@@ -8,7 +8,7 @@ from rich.panel import Panel
 from rich.table import Table
 from rich.text import Text
 
-from machineconfig.scripts.python.repos_helper_update import RepositoryUpdateResult, run_uv_sync, update_repository
+from machineconfig.scripts.python.repos_helpers.repos_helper_update import RepositoryUpdateResult, run_uv_sync, update_repository
 from machineconfig.utils.io import read_ini
 from machineconfig.utils.source_of_truth import DEFAULTS_PATH
 

machineconfig/scripts/python/fire_jobs.py

@@ -12,7 +12,7 @@ from machineconfig.utils.options import choose_from_options
 from machineconfig.utils.path_helper import match_file_name, sanitize_path
 from machineconfig.utils.path_extended import PathExtended
 from machineconfig.utils.accessories import get_repo_root, randstr
-from machineconfig.scripts.python.fire_jobs_args_helper import FireJobArgs, extract_kwargs, parse_fire_args_from_context
+from machineconfig.scripts.python.helpers_fire_command.fire_jobs_args_helper import FireJobArgs, extract_kwargs, parse_fire_args_from_context
 
 import platform
 from typing import Optional, Annotated
@@ -55,13 +55,13 @@ def route(args: FireJobArgs, fire_args: str = "") -> None:
     # =========================  choosing function to run
     choice_function: Optional[str] = None  # Initialize to avoid unbound variable
     if args.choose_function:
-        from machineconfig.scripts.python.fire_jobs_route_helper import choose_function_or_lines
+        from machineconfig.scripts.python.helpers_fire_command.fire_jobs_route_helper import choose_function_or_lines
         choice_function, choice_file, kwargs_dict = choose_function_or_lines(choice_file, kwargs_dict)
     else:
         choice_function = args.function
 
     if choice_file.suffix == ".py":
-        from machineconfig.scripts.python.fire_jobs_route_helper import get_command_streamlit
+        from machineconfig.scripts.python.helpers_fire_command.fire_jobs_route_helper import get_command_streamlit
         if args.streamlit:  exe = get_command_streamlit(choice_file, args.environment, repo_root)
         elif args.interactive is False: exe = "python"
         elif args.jupyter: exe = "jupyter-lab"

machineconfig/scripts/python/helpers/repo_sync_helpers.py

@@ -1,13 +1,26 @@
 from machineconfig.utils.path_extended import PathExtended
-from machineconfig.scripts.python.get_zellij_cmd import get_zellij_cmd
 from machineconfig.utils.code import write_shell_script_to_file
 import platform
+from pathlib import Path
 from rich.console import Console
 from rich.panel import Panel
 
 console = Console()
 
 
+def get_zellij_cmd(wd1: Path, wd2: Path) -> str:
+    _ = wd1, wd2
+    lines = [
+        """ zellij action new-tab --name gitdiff""",
+        """zellij action new-pane --direction down --name local --cwd ./data """,
+        """zellij action write-chars "cd '{wd1}'; git status" """,
+        """zellij action move-focus up; zellij action close-pane """,
+        """zellij action new-pane --direction down --name remote --cwd code """,
+        """zellij action write-chars "cd '{wd2}' """,
+        """git status" """,
+    ]
+    return "; ".join(lines)
+
 def delete_remote_repo_copy_and_push_local(remote_repo: str, local_repo: str, cloud: str):
     console.print(Panel("🗑️  Deleting remote repo copy and pushing local copy", title="[bold blue]Repo Sync[/bold blue]", border_style="blue"))
     repo_sync_root = PathExtended(remote_repo).expanduser().absolute()

machineconfig/scripts/python/{fire_agents_help_launch.py → helpers_fire/fire_agents_help_launch.py}

@@ -2,7 +2,7 @@
 import random
 import shlex
 from pathlib import Path
-from machineconfig.scripts.python.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER
+from machineconfig.scripts.python.helpers_fire.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER
 
 
 def get_gemini_api_keys() -> list[str]:

machineconfig/scripts/python/helpers_repos/grource.py

@@ -0,0 +1,341 @@
+"""Gource visualization tool for git repositories."""
+
+from pathlib import Path
+from typing import Annotated, Optional
+import subprocess
+import platform
+import zipfile
+import typer
+
+
+def get_gource_install_dir() -> Path:
+    """Get the installation directory for portable Gource."""
+    if platform.system() == "Windows":
+        appdata = Path.home() / "AppData" / "Local"
+        return appdata / "gource"
+    else:
+        return Path.home() / ".local" / "bin" / "gource"
+
+
+def get_gource_executable() -> Path:
+    """Get the path to the gource executable (inside the extracted directory with DLLs)."""
+    install_dir = get_gource_install_dir()
+    if platform.system() == "Windows":
+        possible_paths = [
+            install_dir / "gource.exe",
+            install_dir / f"gource-{get_default_version()}.win64" / "gource.exe",
+        ]
+        for path in possible_paths:
+            if path.exists():
+                return path
+        return install_dir / f"gource-{get_default_version()}.win64" / "gource.exe"
+    else:
+        return install_dir / "gource"
+
+
+def get_default_version() -> str:
+    """Get the default gource version."""
+    return "0.53"
+
+
+def install_gource_windows(version: Optional[str] = None) -> None:
+    """Install portable Gource on Windows by downloading and extracting the zip archive."""
+    if platform.system() != "Windows":
+        raise OSError(f"This installer is for Windows only. Current OS: {platform.system()}")
+
+    from machineconfig.utils.path_extended import PathExtended
+    from machineconfig.utils.source_of_truth import INSTALL_TMP_DIR
+
+    print("\n" + "=" * 80)
+    print("🚀 GOURCE PORTABLE INSTALLATION 🚀")
+    print("=" * 80 + "\n")
+
+    version_str = version or get_default_version()
+    portable_url = f"https://github.com/acaudwell/Gource/releases/download/gource-{version_str}/gource-{version_str}.win64.zip"
+    install_dir = get_gource_install_dir()
+
+    print(f"📥 Downloading portable Gource from: {portable_url}")
+    downloaded_zip = PathExtended(portable_url).download(folder=INSTALL_TMP_DIR)
+    print(f"✅ Downloaded to: {downloaded_zip}")
+
+    print(f"\n� Extracting to: {install_dir}")
+    install_dir.mkdir(parents=True, exist_ok=True)
+
+    try:
+        with zipfile.ZipFile(downloaded_zip, 'r') as zip_ref:
+            zip_ref.extractall(install_dir)
+        print(f"✅ Extracted successfully to: {install_dir}")
+        print(f"   (The zip contains gource-{version_str}.win64/ directory with exe and DLL dependencies)")
+    except Exception as e:
+        print(f"❌ Extraction failed with error: {e}")
+        raise
+
+    print("\n🗑️  Cleaning up zip file...")
+    try:
+        downloaded_zip.unlink()
+        print(f"✅ Removed zip file: {downloaded_zip}")
+    except Exception as e:
+        print(f"⚠️  Warning: Could not remove zip file: {e}")
+
+    gource_exe = get_gource_executable()
+    if gource_exe.exists():
+        print(f"\n✅ Gource executable found at: {gource_exe}")
+        dll_dir = gource_exe.parent
+        dll_count = len(list(dll_dir.glob("*.dll")))
+        print(f"   Found {dll_count} DLL dependencies in: {dll_dir}")
+    else:
+        print(f"\n⚠️  Warning: Expected executable not found at: {gource_exe}")
+        print(f"   Contents of {install_dir}:")
+        for item in install_dir.rglob("*"):
+            if item.is_file():
+                print(f"     - {item.relative_to(install_dir)}")
+
+    print("\n" + "=" * 80)
+    print("✅ GOURCE PORTABLE INSTALLATION COMPLETED")
+    print("=" * 80)
+    print(f"\n📌 Gource installed to: {install_dir}")
+    print(f"   Executable: {gource_exe}")
+    print("   All DLL dependencies are kept together in the same directory.")
+    print("   This script will automatically use the portable version.")
+
+
+def visualize(
+    repo: Annotated[str, typer.Option("--repo", "-r", help="Path to git repository to visualize")] = Path.cwd().__str__(),
+    output_file: Annotated[Optional[Path], typer.Option("--output", "-o", help="Output video file (e.g., output.mp4). If specified, gource will render to video.")] = None,
+    resolution: Annotated[str, typer.Option("--resolution", "-res", help="Video resolution (e.g., 1920x1080, 1280x720)")] = "1920x1080",
+    seconds_per_day: Annotated[float, typer.Option("--seconds-per-day", "-spd", help="Speed of simulation (lower = faster)")] = 0.1,
+    auto_skip_seconds: Annotated[float, typer.Option("--auto-skip-seconds", "-as", help="Skip to next entry if nothing happens for X seconds")] = 1.0,
+    title: Annotated[Optional[str], typer.Option("--title", "-t", help="Title for the visualization")] = None,
+    hide_items: Annotated[list[str], typer.Option("--hide", "-h", help="Items to hide: bloom, date, dirnames, files, filenames, mouse, progress, root, tree, users, usernames")] = [],
+    key_items: Annotated[bool, typer.Option("--key", "-k", help="Show file extension key")] = False,
+    fullscreen: Annotated[bool, typer.Option("--fullscreen", "-f", help="Run in fullscreen mode")] = False,
+    viewport: Annotated[Optional[str], typer.Option("--viewport", "-v", help="Camera viewport (e.g., '1000x1000')")] = None,
+    start_date: Annotated[Optional[str], typer.Option("--start-date", help="Start date (YYYY-MM-DD)")] = None,
+    stop_date: Annotated[Optional[str], typer.Option("--stop-date", help="Stop date (YYYY-MM-DD)")] = None,
+    user_image_dir: Annotated[Optional[Path], typer.Option("--user-image-dir", help="Directory with user avatar images")] = None,
+    max_files: Annotated[int, typer.Option("--max-files", help="Maximum number of files to show (0 = no limit)")] = 0,
+    max_file_lag: Annotated[float, typer.Option("--max-file-lag", help="Max time files remain on screen after last change")] = 5.0,
+    file_idle_time: Annotated[int, typer.Option("--file-idle-time", help="Time in seconds files remain idle before being removed")] = 0,
+    framerate: Annotated[int, typer.Option("--framerate", help="Frames per second for video output")] = 60,
+    background_color: Annotated[str, typer.Option("--background-color", help="Background color in hex (e.g., 000000 for black)")] = "000000",
+    font_size: Annotated[int, typer.Option("--font-size", help="Font size")] = 22,
+    camera_mode: Annotated[str, typer.Option("--camera-mode", help="Camera mode: overview or track")] = "overview",
+) -> None:
+    """
+    Visualize git repository history using Gource with reasonable defaults.
+    
+    Examples:
+        # Basic visualization of current directory
+        python grource.py visualize
+        
+        # Visualize specific repository
+        python grource.py visualize --repo-path /path/to/repo
+        
+        # Create video output
+        python grource.py visualize --output output.mp4
+        
+        # Fast visualization with custom title
+        python grource.py visualize --seconds-per-day 0.01 --title "My Project"
+        
+        # Hide specific elements
+        python grource.py visualize --hide filenames --hide date
+        
+        # Custom resolution and viewport
+        python grource.py visualize --resolution 2560x1440 --viewport 1200x1200
+    """
+    print("\n" + "=" * 80)
+    print("🎬 GOURCE VISUALIZATION 🎬")
+    print("=" * 80 + "\n")
+    repo_path: Path = Path(repo).expanduser().resolve()
+    if not repo_path.exists():
+        print(f"❌ Error: Repository path does not exist: {repo_path}")
+        raise typer.Exit(1)
+
+    if not repo_path.joinpath(".git").exists():
+        print(f"❌ Error: Not a git repository: {repo_path}")
+        raise typer.Exit(1)
+
+    print(f"📁 Repository: {repo_path}")
+    print("⚙️  Configuration:")
+    print(f"   - Resolution: {resolution}")
+    print(f"   - Speed: {seconds_per_day} seconds per day")
+    print(f"   - Auto-skip: {auto_skip_seconds} seconds")
+    if output_file:
+        print(f"   - Output: {output_file}")
+    print()
+
+    gource_exe: Path = get_gource_executable()
+    if not gource_exe.exists():
+        if platform.system() == "Windows":
+            print(f"⚠️  Portable gource not found at {gource_exe}, installing...")
+            install_gource_windows()
+            # Check again after installation
+            if gource_exe.exists():
+                print(f"✅ Gource installed successfully at: {gource_exe}")
+                gource_cmd: str = str(gource_exe)
+            else:
+                print("❌ Installation failed, falling back to system gource")
+                gource_cmd = "gource"
+        else:
+            gource_cmd = "gource"
+            print(f"⚠️  Portable gource not found at {gource_exe}, using system gource")
+    else:
+        gource_cmd = str(gource_exe)
+
+    cmd: list[str] = [gource_cmd, str(repo_path)]
+
+    cmd.extend(["--seconds-per-day", str(seconds_per_day)])
+    cmd.extend(["--auto-skip-seconds", str(auto_skip_seconds)])
+
+    if resolution:
+        width, height = resolution.split("x")
+        cmd.extend(["-{}x{}".format(width, height)])
+
+    if title:
+        cmd.extend(["--title", title])
+    elif not title and not output_file:
+        cmd.extend(["--title", repo_path.name])
+
+    for hide_item in hide_items:
+        cmd.extend(["--hide", hide_item])
+
+    if key_items:
+        cmd.append("--key")
+
+    if fullscreen and not output_file:
+        cmd.append("--fullscreen")
+
+    if viewport:
+        cmd.extend(["--viewport", viewport])
+
+    if start_date:
+        cmd.extend(["--start-date", start_date])
+
+    if stop_date:
+        cmd.extend(["--stop-date", stop_date])
+
+    if user_image_dir and user_image_dir.exists():
+        cmd.extend(["--user-image-dir", str(user_image_dir)])
+
+    if max_files > 0:
+        cmd.extend(["--max-files", str(max_files)])
+
+    cmd.extend(["--max-file-lag", str(max_file_lag)])
+
+    if file_idle_time > 0:
+        cmd.extend(["--file-idle-time", str(file_idle_time)])
+
+    cmd.extend(["--background-colour", background_color])
+    cmd.extend(["--font-size", str(font_size)])
+    cmd.extend(["--camera-mode", camera_mode])
+
+    if output_file:
+        cmd.extend(["-r", str(framerate)])
+        if platform.system() == "Windows":
+            cmd.extend(["-o", "-"])
+            ffmpeg_cmd: list[str] = [
+                "ffmpeg",
+                "-y",
+                "-r", str(framerate),
+                "-f", "image2pipe",
+                "-vcodec", "ppm",
+                "-i", "-",
+                "-vcodec", "libx264",
+                "-preset", "medium",
+                "-pix_fmt", "yuv420p",
+                "-crf", "23",
+                str(output_file),
+            ]
+            print("🎥 Rendering video...")
+            print(f"   Command: {' '.join(cmd)} | {' '.join(ffmpeg_cmd)}")
+            print()
+            try:
+                gource_proc: subprocess.Popen[bytes] = subprocess.Popen(cmd, stdout=subprocess.PIPE)
+                ffmpeg_proc: subprocess.Popen[bytes] = subprocess.Popen(ffmpeg_cmd, stdin=gource_proc.stdout)
+                if gource_proc.stdout:
+                    gource_proc.stdout.close()
+                ffmpeg_proc.communicate()
+                print(f"\n✅ Video saved to: {output_file}")
+            except subprocess.CalledProcessError as e:
+                print(f"❌ Error during video rendering: {e}")
+                raise typer.Exit(1)
+            except FileNotFoundError:
+                print("❌ Error: ffmpeg not found. Please install ffmpeg to create video output.")
+                print("   Download from: https://ffmpeg.org/download.html")
+                raise typer.Exit(1)
+        else:
+            cmd.extend(["-o", "-"])
+            ffmpeg_cmd = [
+                "ffmpeg",
+                "-y",
+                "-r", str(framerate),
+                "-f", "image2pipe",
+                "-vcodec", "ppm",
+                "-i", "-",
+                "-vcodec", "libx264",
+                "-preset", "medium",
+                "-pix_fmt", "yuv420p",
+                "-crf", "23",
+                str(output_file),
+            ]
+            print("🎥 Rendering video...")
+            print(f"   Command: {' '.join(cmd)} | {' '.join(ffmpeg_cmd)}")
+            print()
+            try:
+                gource_proc = subprocess.Popen(cmd, stdout=subprocess.PIPE)
+                ffmpeg_proc = subprocess.Popen(ffmpeg_cmd, stdin=gource_proc.stdout)
+                if gource_proc.stdout:
+                    gource_proc.stdout.close()
+                ffmpeg_proc.communicate()
+                print(f"\n✅ Video saved to: {output_file}")
+            except subprocess.CalledProcessError as e:
+                print(f"❌ Error during video rendering: {e}")
+                raise typer.Exit(1)
+            except FileNotFoundError:
+                print("❌ Error: ffmpeg not found. Please install ffmpeg to create video output.")
+                raise typer.Exit(1)
+    else:
+        print("🎬 Launching interactive visualization...")
+        print(f"   Command: {' '.join(cmd)}")
+        print()
+        try:
+            subprocess.run(cmd, check=True)
+        except subprocess.CalledProcessError as e:
+            print(f"❌ Error running gource: {e}")
+            raise typer.Exit(1)
+        except FileNotFoundError:
+            print("❌ Error: gource not found. Please install gource first.")
+            if platform.system() == "Windows":
+                print("   Run: uv run python src/machineconfig/scripts/python/grource.py install")
+            else:
+                print("   For Linux/Mac, use your package manager:")
+                print("     - Ubuntu/Debian: sudo apt install gource")
+                print("     - macOS: brew install gource")
+                print("     - Fedora: sudo dnf install gource")
+            raise typer.Exit(1)
+
+    print("\n" + "=" * 80)
+    print("✅ VISUALIZATION COMPLETED")
+    print("=" * 80)
+
+
+def install(
+    version: Optional[str] = typer.Option("0.53", "--version", "-v", help="Gource version to install"),
+) -> None:
+    """Install portable Gource on Windows (no admin privileges required)."""
+    if platform.system() == "Windows":
+        install_gource_windows(version=version)
+    else:
+        print(f"❌ Portable installer currently supports Windows only. Current OS: {platform.system()}")
+        print("For Linux/Mac, please use your package manager:")
+        print("  - Ubuntu/Debian: sudo apt install gource")
+        print("  - macOS: brew install gource")
+        print("  - Fedora: sudo dnf install gource")
+        raise typer.Exit(1)
+
+
+if __name__ == "__main__":
+    app = typer.Typer(help="Gource visualization tool for git repositories")
+    app.command()(install)
+    app.command()(visualize)
+    app()

machineconfig/scripts/python/interactive.py

@@ -36,7 +36,6 @@ console = Console()
 def display_header() -> None:
     from machineconfig.utils.installer import get_machineconfig_version
     from rich.align import Align
-    from rich.padding import Padding
 
     # Fancy ASCII art header
     ascii_art = """
@@ -57,23 +56,16 @@ def display_header() -> None:
     subtitle = "🎯 Your digital life manager. Dotfiles, data, code and more."
     bug_report = "🐛 Please report bugs to Alex Al-Saffar @ https://github.com/thisismygitrepo/machineconfig"
 
-    # Create styled texts
-    ascii_text = Text(ascii_art, style="bold cyan")
-    title_text = Text(title, style="bold bright_magenta")
-    subtitle_text = Text(subtitle, style="italic bright_blue")
-    bug_text = Text(bug_report, style="dim white")
-
-    # Create panel content with proper alignment
-    with console.capture() as capture:
-        console.print(ascii_text)
-        console.print()
-        console.print(Align.center(title_text))
-        console.print(Align.center(subtitle_text))
-        console.print()
-        console.print(Align.center(bug_text))
-
-    panel_content = capture.get()
-    console.print(Panel(Padding(panel_content, (1, 2)), border_style="bright_cyan", padding=(1, 2)))
+    # Print ASCII art
+    console.print(Text(ascii_art, style="bold cyan"))
+    console.print()
+    
+    # Print centered text elements
+    console.print(Align.center(Text(title, style="bold bright_magenta")))
+    console.print(Align.center(Text(subtitle, style="italic bright_blue")))
+    console.print()
+    console.print(Align.center(Text(bug_report, style="dim white")))
+    console.print()
 def display_completion_message() -> None:
     completion_text = Text("INSTALLATION COMPLETE", style="bold green")
     subtitle_text = Text("System setup finished successfully", style="italic green")
@@ -190,7 +182,7 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
         console.print(Panel("💾 [bold bright_cyan]DATA RETRIEVAL[/bold bright_cyan]\n[italic]Backup restoration[/italic]", border_style="bright_cyan"))
         console.print("🔧 Retrieving backup data", style="bold cyan")
         try:
-            from machineconfig.scripts.python.devops_backup_retrieve import main_backup_retrieve
+            from machineconfig.scripts.python.devops_helpers.devops_backup_retrieve import main_backup_retrieve
             main_backup_retrieve(direction="RETRIEVE")
             console.print("✅ Backup data retrieved successfully", style="bold green")
         except Exception as e: