stackops 26.7__tar.gz → 26.8__tar.gz

stackops-26.8/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: stackops
+Version: 26.8
+Summary: Developer Stack Manager
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/stackops
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/stackops/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fire>=0.7.1
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: typer>=0.24.1
+Provides-Extra: windows
+Provides-Extra: plot
+Requires-Dist: duckdb>=1.5.4; extra == "plot"
+Requires-Dist: duckdb-engine>=0.17.0; extra == "plot"
+Requires-Dist: ipykernel>=7.3.0; extra == "plot"
+Requires-Dist: ipython>=9.15.0; extra == "plot"
+Requires-Dist: jupyterlab>=4.6.0; extra == "plot"
+Requires-Dist: kaleido>=1.3.0; extra == "plot"
+Requires-Dist: matplotlib>=3.11.0; extra == "plot"
+Requires-Dist: nbformat>=5.10.4; extra == "plot"
+Requires-Dist: numpy>=2.5.0; extra == "plot"
+Requires-Dist: plotly>=6.8.0; extra == "plot"
+Requires-Dist: polars>=1.42.0; extra == "plot"
+Requires-Dist: python-magic>=0.4.27; extra == "plot"
+Requires-Dist: sqlalchemy>=2.0.51; extra == "plot"
+
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Digital Life Manager.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestrator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+
+
+| Before | After |
+| --- | --- |
+| ![Fresh minimal machine state](docs/assets/before.png) | ![Developer-ready machine state](docs/assets/after.png) |
+
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: irm bit.ly/sopsw | iex
+```
+
+</details>
+
+
+## Codex Skill
+
+Install the StackOps skill for Codex with:
+
+```bash
+bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes
+```
+
+
+## Quick Init
+
+Run these once StackOps is installed.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict throw-error \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, and SSH transfer helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the full tree.
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.8/pyproject.toml

@@ -0,0 +1,178 @@
+[build-system]
+requires = ["setuptools>=80", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "stackops"
+version = "26.8"
+description = "Developer Stack Manager"
+readme = "README.md"
+license = {text = "Apache 2.0"}
+authors = [
+    {name = "Alex Al-Saffar", email = "programmer@usa.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "fire>=0.7.1",
+    "gitpython>=3.1.46",
+    "psutil>=7.2.2",
+    "pyyaml>=6.0.3",
+    "questionary>=2.1.1",
+    "randomname>=0.2.1",
+    "requests>=2.32.5",
+    "rich>=14.3.3",
+    "tenacity>=9.1.4",
+    "typer>=0.24.1",
+]
+
+[project.optional-dependencies]
+windows = []
+plot = [
+    "duckdb>=1.5.4",
+    "duckdb-engine>=0.17.0",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
+    "nbformat>=5.10.4",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.51",
+]
+
+
+[project.urls]
+"Homepage" = "https://github.com/thisismygitrepo/stackops"
+"Bug Tracker" = "https://github.com/thisismygitrepo/stackops/issues"
+
+[project.scripts]
+devops = "stackops.scripts.python.devops:main"
+cloud = "stackops.scripts.python.cloud:main"
+fire = "stackops.scripts.python.fire_jobs:main"
+agents = "stackops.scripts.python.agents:main"
+terminal = "stackops.scripts.python.terminal:main"
+preview = "stackops.scripts.python.preview:main"
+utils = "stackops.scripts.python.utils:main"
+stackops = "stackops.scripts.python.stackops_entry:main"
+seek = "stackops.scripts.python.seek:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+stackops = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1", "**/*.txt", "utils/schemas/**/*.json", "utils/schemas/**/*.yaml"]
+
+[dependency-groups]
+dev = [
+    "aider>=0.2.6",
+    "build>=1.5.0",
+    "cleanpy>=0.5.1",
+    "cowsay>=6.1",
+    "duckdb>=1.5.4",
+    "gdown>=6.1.0",
+    "griffe>=2.1.0",
+    "ipdb>=0.13.13",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jsonschema>=4.26.0",
+    "kaleido>=1.3.0",
+    "marimo>=0.23.11",
+    "matplotlib>=3.11.0",
+    "mkdocstrings>=1.0.4",
+    "mkdocstrings-python>=2.0.5",
+    "mypy>=2.1.0",
+    "numpy>=2.5.0",
+    "pandas>=3.0.3",
+    "paramiko>=5.0.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "pre-commit>=4.6.0",
+    "pudb>=2025.1.5",
+    "py7zr>=1.1.3",
+    "pydantic>=2.13.4",
+    "pydeps>=3.0.6",
+    "pyinstaller>=6.21.0",
+    "pylint>=4.0.6",
+    "pylsp-mypy>=0.7.3",
+    "pymupdf>=1.27.2.3",
+    "pypdf>=6.14.2",
+    "pyrefly>=1.1.1",
+    "pyright>=1.1.411",
+    "pytest>=9.1.1",
+    "python-lsp-server[mypy]>=1.14.0",
+    "qrcode>=8.2",
+    "ruff>=0.15.20",
+    "ruff-lsp>=0.0.62",
+    "sqlalchemy>=2.0.51",
+    "textual>=8.2.7",
+    "trogon>=0.6.0",
+    "ty>=0.0.55",
+    "types-mysqlclient>=2.2.0.20260508",
+    "types-paramiko>=5.0.0.20260617",
+    "types-pytz>=2026.2.0.20260518",
+    "types-pyyaml>=6.0.12.20260518",
+    "types-requests>=2.33.0.20260518",
+    "types-sqlalchemy>=1.4.53.38",
+    "types-toml>=0.10.8.20260518",
+    "types-urllib3>=1.26.25.14",
+    "vt-py>=0.22.0",
+    "yapf>=0.43.0",
+    "zensical>=0.0.46",
+]
+other = [
+    "duckdb-engine>=0.17.0",
+    "pycrucible>=0.4.6",
+    "vt-py>=0.22.0",
+]
+plot = [
+    "duckdb>=1.5.4",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
+    "nbformat>=5.10.4",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.51",
+]
+
+
+# [tool.uv]
+# default-groups = []
+
+[tool.pycrucible]
+entry = "src/stackops/scripts/python/devops.py"
+[tool.pycrucible.options]
+debug = false
+extract_to_temp = false
+delete_after_run = false
+offline_mode = false
+
+[tool.pycrucible.patterns]
+include = [
+    "**/*.py",
+    "**/*.ps1",
+    "**/*.sh",
+    "**/*.md",
+]
+exclude = [
+    "**/__pycache__/**",
+]

stackops-26.8/src/stackops/jobs/installer/linux_scripts/__init__.py

@@ -0,0 +1,4 @@
+NETWORK_PATH_REFERENCE = "network.sh"
+NGROK_PATH_REFERENCE = "ngrok.sh"
+Q_PATH_REFERENCE = "q.sh"
+SYSABC_MACOS_PATH_REFERENCE = "sysabc_macos.sh"

stackops-26.8/src/stackops/jobs/installer/linux_scripts/ngrok.sh

@@ -0,0 +1,6 @@
+curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
+  | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
+  && echo "deb https://ngrok-agent.s3.amazonaws.com bookworm main" \
+  | sudo tee /etc/apt/sources.list.d/ngrok.list \
+  && sudo apt-get update \
+  && sudo apt-get install -y ngrok

stackops-26.8/src/stackops/jobs/installer/python_scripts/brave.py

@@ -0,0 +1,117 @@
+"""brave installer"""
+
+import platform
+from typing import TYPE_CHECKING
+
+from rich import box
+from rich.console import Console
+from rich.panel import Panel
+
+from stackops.utils.code import run_shell_script
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.linux_package_manager import LinuxDistribution, detect_current_linux_distribution
+from stackops.utils.meta import print_code
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+def _build_linux_install_script(distribution: LinuxDistribution) -> str:
+    match (distribution.distribution_id, distribution.package_manager):
+        case ("alpine", "apk"):
+            raise NotImplementedError("Brave Browser does not publish an Alpine Linux APK package.")
+        case (unsupported_distribution_id, "apk"):
+            raise ValueError(f"Invalid package-manager metadata for Linux distribution '{unsupported_distribution_id}': manager=apk")
+        case (_, "apt"):
+            repository_setup = """
+echo "📥 Installing APT repository prerequisites..."
+sudo apt-get update
+sudo apt-get install -y curl
+
+echo "🔐 Adding Brave's official signing key and repository..."
+sudo curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg
+sudo curl -fsSLo /etc/apt/sources.list.d/brave-browser-release.sources https://brave-browser-apt-release.s3.brave.com/brave-browser.sources
+sudo apt-get update
+"""
+            install_command = "sudo apt-get install -y brave-browser"
+        case ("fedora", "dnf"):
+            repository_setup = """
+echo "📥 Installing DNF repository prerequisites..."
+sudo dnf install -y dnf-plugins-core
+
+echo "📝 Adding Brave's official Fedora repository..."
+sudo dnf config-manager addrepo --from-repofile=https://brave-browser-rpm-release.s3.brave.com/brave-browser.repo
+"""
+            install_command = "sudo dnf install -y brave-browser"
+        case ("rhel" | "rocky" | "centos", "dnf"):
+            repository_setup = """
+echo "📥 Installing DNF repository prerequisites..."
+sudo dnf install -y dnf-plugins-core
+
+echo "📝 Adding Brave's official RPM repository..."
+sudo dnf config-manager --add-repo https://brave-browser-rpm-release.s3.brave.com/brave-browser.repo
+"""
+            install_command = "sudo dnf install -y brave-browser"
+        case (unsupported_distribution_id, "dnf"):
+            raise NotImplementedError(
+                "Brave's official RPM instructions do not support Linux distribution "
+                f"'{unsupported_distribution_id}'. Supported RPM distributions: fedora, rhel, rocky, centos."
+            )
+        case ("arch", "pacman"):
+            raise NotImplementedError("Brave Browser is only available through the AUR on Arch Linux; pacman cannot install it.")
+        case (unsupported_distribution_id, "pacman"):
+            raise ValueError(f"Invalid package-manager metadata for Linux distribution '{unsupported_distribution_id}': manager=pacman")
+
+    return f"""#!/usr/bin/env bash
+set -euo pipefail
+
+echo "🦁 Installing Brave on {distribution.distribution_id} with {distribution.package_manager}"
+{repository_setup}
+
+echo "📦 Installing Brave Browser..."
+{install_command}
+
+echo "✅ Brave Browser installation completed"
+"""
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> None:
+    console = Console()
+    _ = installer_data, update
+    system = platform.system()
+    console.print(
+        Panel.fit(
+            "\n".join([f"💻 Platform: {system}", f"🔄 Version: {'latest' if version is None else version}"]),
+            title="🦁 Brave Browser Installer",
+            border_style="orange1",
+            box=box.ROUNDED,
+        )
+    )
+
+    match system:
+        case "Windows":
+            console.print("🪟 Installing Brave Browser on Windows using winget...", style="bold")
+            program = """
+winget install --no-upgrade --name "Brave" --Id "Brave.Brave" --source winget --scope user --accept-package-agreements --accept-source-agreements
+"""
+        case "Linux":
+            distribution = detect_current_linux_distribution()
+            console.print(f"🐧 Installing Brave Browser on {distribution.distribution_id} with its official repository...", style="bold")
+            program = _build_linux_install_script(distribution)
+        case "Darwin":
+            console.print("🍎 Installing Brave Browser on macOS...", style="bold")
+            program = "brew install --cask brave-browser"
+        case _:
+            error_msg = f"Unsupported platform: {system}"
+            console.print(Panel.fit(error_msg, title="❌ Error", subtitle="⚠️ Unsupported platform", border_style="red", box=box.ROUNDED))
+            raise NotImplementedError(error_msg)
+
+    print_code(code=program, lexer="shell", desc="Installation Script Preview")
+    result = run_shell_script(program, display_script=True, clean_env=False)
+    if result.returncode != 0:
+        raise RuntimeError(f"Brave Browser installation failed with exit code {result.returncode}")
+    console.print("✅ Installation completed successfully!", style="bold green")
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main
+    pass

stackops-26.8/src/stackops/jobs/installer/python_scripts/cloudflare_warp_cli.py

@@ -0,0 +1,84 @@
+import platform
+import subprocess
+from typing import TYPE_CHECKING
+
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.linux_package_manager import LinuxDistribution, detect_current_linux_distribution
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+def _build_linux_install_script(distribution: LinuxDistribution) -> str:
+    match (distribution.distribution_id, distribution.package_manager):
+        case ("alpine", "apk"):
+            raise NotImplementedError("Cloudflare WARP does not publish an Alpine Linux APK repository or package.")
+        case ("ubuntu" | "debian", "apt"):
+            repository_setup = """
+echo "📥 Installing APT repository prerequisites..."
+sudo apt-get update
+sudo apt-get install -y curl gpg lsb-release
+
+echo "🔐 Adding Cloudflare's current signing key..."
+curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --yes --dearmor --output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
+
+echo "📝 Adding Cloudflare's APT repository..."
+echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list > /dev/null
+sudo apt-get update
+"""
+            install_command = "sudo apt-get install -y cloudflare-warp"
+        case ("fedora", "dnf"):
+            repository_setup = """
+echo "📥 Installing RPM repository prerequisites..."
+sudo dnf install -y curl
+
+echo "🔐 Importing Cloudflare's current signing key..."
+sudo rpm --import https://pkg.cloudflareclient.com/pubkey.gpg
+
+echo "📝 Adding Cloudflare's RPM repository..."
+sudo curl -fsSLo /etc/yum.repos.d/cloudflare-warp.repo https://pkg.cloudflareclient.com/cloudflare-warp-ascii.repo
+sudo dnf makecache --refresh
+"""
+            install_command = "sudo dnf install -y cloudflare-warp"
+        case ("rhel" | "centos", "dnf"):
+            raise NotImplementedError("Cloudflare WARP on RHEL and CentOS requires an explicit, version-specific EPEL setup.")
+        case (unsupported_distribution_id, _):
+            raise NotImplementedError(
+                "Cloudflare's package repository does not support Linux distribution "
+                f"'{unsupported_distribution_id}'. Supported without extra repositories: ubuntu, debian, fedora."
+            )
+
+    return f"""#!/usr/bin/env bash
+set -euo pipefail
+
+echo "🔒 Installing Cloudflare WARP on {distribution.distribution_id} with {distribution.package_manager}"
+{repository_setup}
+
+echo "📦 Installing Cloudflare WARP..."
+{install_command}
+
+echo "📡 Registering the WARP client..."
+warp-cli registration new
+
+echo "✅ Cloudflare WARP installation completed"
+"""
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> str:
+    _ = installer_data, version, update
+    system = platform.system()
+    match system:
+        case "Windows":
+            raise NotImplementedError("Installer is not yet implemented for Windows.")
+        case "Linux":
+            distribution = detect_current_linux_distribution()
+            program = _build_linux_install_script(distribution)
+        case "Darwin":
+            program = "brew install --cask cloudflare-warp"
+        case _:
+            raise NotImplementedError(f"Unsupported platform: {system}")
+    subprocess.run(["bash", "-c", program], text=True, check=True)
+    return f"Cloudflare WARP CLI installed successfully on {system}."
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main

stackops-26.8/src/stackops/jobs/installer/python_scripts/code.py

@@ -0,0 +1,117 @@
+"""vs code installer as per https://code.visualstudio.com/docs/setup/linux"""
+
+import platform
+from typing import TYPE_CHECKING, assert_never
+
+from rich import box
+from rich.console import Console
+from rich.panel import Panel
+
+from stackops.utils.code import run_shell_script
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.linux_package_manager import LinuxDistribution, detect_current_linux_distribution
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+def _build_linux_install_script(distribution: LinuxDistribution) -> str:
+    match distribution.package_manager:
+        case "apk":
+            raise NotImplementedError("Microsoft Visual Studio Code does not publish an Alpine Linux APK repository or package.")
+        case "apt":
+            repository_setup = """
+echo "📥 Installing APT repository prerequisites..."
+sudo apt-get update
+sudo apt-get install -y wget gpg
+
+echo "🔐 Adding Microsoft's signing key..."
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --yes --dearmor -o /usr/share/keyrings/microsoft.gpg
+
+echo "📝 Adding Microsoft's VS Code repository..."
+sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null <<'EOF'
+Types: deb
+URIs: https://packages.microsoft.com/repos/code
+Suites: stable
+Components: main
+Architectures: amd64,arm64,armhf
+Signed-By: /usr/share/keyrings/microsoft.gpg
+EOF
+sudo apt-get update
+"""
+            install_command = "sudo apt-get install -y code"
+        case "dnf":
+            repository_setup = """
+echo "🔐 Importing Microsoft's signing key..."
+sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
+
+echo "📝 Adding Microsoft's VS Code repository..."
+sudo tee /etc/yum.repos.d/vscode.repo > /dev/null <<'EOF'
+[code]
+name=Visual Studio Code
+baseurl=https://packages.microsoft.com/yumrepos/vscode
+enabled=1
+autorefresh=1
+type=rpm-md
+gpgcheck=1
+gpgkey=https://packages.microsoft.com/keys/microsoft.asc
+EOF
+sudo dnf makecache --refresh
+"""
+            install_command = "sudo dnf install -y code"
+        case "pacman":
+            raise NotImplementedError("Microsoft Visual Studio Code is only available through the AUR on Arch Linux; pacman cannot install it.")
+        case _:
+            assert_never(distribution.package_manager)
+
+    return f"""#!/usr/bin/env bash
+set -euo pipefail
+
+echo "💻 Installing VS Code on {distribution.distribution_id} with {distribution.package_manager}"
+{repository_setup}
+
+echo "📦 Installing Visual Studio Code..."
+{install_command}
+
+echo "✅ Visual Studio Code installation completed"
+"""
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> None:
+    console = Console()
+    _ = installer_data, update
+    system = platform.system()
+    console.print(
+        Panel.fit(
+            "\n".join([f"🖥️  Platform: {system}", f"🔄 Version: {'latest' if version is None else version}"]),
+            title="💻 VS Code Installer",
+            border_style="blue",
+            box=box.ROUNDED,
+        )
+    )
+
+    match system:
+        case "Linux":
+            distribution = detect_current_linux_distribution()
+            console.print(f"🐧 Installing VS Code on {distribution.distribution_id} with Microsoft's official repository...", style="bold")
+            install_script = _build_linux_install_script(distribution)
+        case "Darwin":
+            console.print("🍎 Installing VS Code on macOS using Homebrew...", style="bold")
+            install_script = "brew install --cask visual-studio-code"
+        case "Windows":
+            console.print("🪟 Installing VS Code on Windows using winget...", style="bold")
+            install_script = """
+winget install --no-upgrade --name "Microsoft Visual Studio Code" --Id "Microsoft.VisualStudioCode" --source winget --scope user --accept-package-agreements --accept-source-agreements
+"""
+        case _:
+            error_msg = f"Unsupported platform: {system}"
+            console.print(Panel.fit(error_msg, title="❌ Error", subtitle="⚠️ Unsupported platform", border_style="red", box=box.ROUNDED))
+            raise NotImplementedError(error_msg)
+
+    result = run_shell_script(install_script, display_script=True, clean_env=False)
+    if result.returncode != 0:
+        raise RuntimeError(f"VS Code installation failed with exit code {result.returncode}")
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main
+    pass