@harry-kp/vortix 0.1.4

package/.gitignore

@@ -0,0 +1,2 @@
+/node_modules
+

package/CHANGELOG.md

@@ -0,0 +1,115 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.4] - 2026-02-12
+
+### Documentation
+
+- Add sudo PATH troubleshooting for cargo install on Linux
+- Restructure README for clarity and fix misleading info
+- Move sudo PATH fix to prominent section after installation
+
+### Features
+
+- Add Homebrew and npm package manager support
+
+
+
+## [0.1.3] - 2026-02-11
+
+### Bug Fixes
+
+- Prevent TUI freeze when no network connection is available
+- **ci:** Gate macOS-only symbols behind cfg to resolve Linux dead_code errors
+- Prevent UTF-8 panic when truncating log messages in TUI
+
+### Documentation
+
+- **readme:** Add installation for arch linux ([#27](https://github.com/Harry-kp/vortix/pull/27))
+- Add directory structure and configuration guide to README
+- Clarify file ownership and permissions in README
+- Update configuration reference with all configurable settings
+
+### Features
+
+- Configurable config directory with settings, migration, and sudo ownership
+- Harden VPN lifecycle, structured logging, and configurable settings
+- Startup dependency check with toast warning for missing tools
+
+
+
+## [0.1.2] - 2026-02-07
+
+### Bug Fixes
+
+- Resolve clippy errors on Linux CI (Rust 1.93)
+
+### Documentation
+
+- Add star history graph to README
+- Add ROADMAP and GitHub Sponsors funding
+- Add downloads and stars badges to README
+- Add Terminal Trove feature mention
+- Fix roadmap links to point to feature requests
+- Add comparison table, CONTRIBUTING.md, and issue/PR templates
+- Add macOS, Rust, Sponsors, and PRs Welcome badges
+
+### Features
+
+- Add Linux platform support with cross-platform abstraction layer
+- Robust VPN state machine and strict config import validation
+- OpenVPN credential management and UX improvements
+
+### Miscellaneous
+
+- **deps:** Bump clap from 4.5.54 to 4.5.56 in the rust-minor group ([#23](https://github.com/Harry-kp/vortix/pull/23))
+
+
+
+## [0.1.1] - 2026-01-14
+
+### Bug Fixes
+
+- Address Clippy and Copilot review comments
+
+### Miscellaneous
+
+- **deps:** Bump nix from 0.29.0 to 0.30.1 ([#7](https://github.com/Harry-kp/vortix/pull/7))
+- **deps:** Bump libc from 0.2.179 to 0.2.180 in the rust-minor group ([#9](https://github.com/Harry-kp/vortix/pull/9))
+
+### Refactor
+
+- Centralized logging, optimized deps, improved UI
+
+
+
+## [0.1.0] - 2026-01-02
+
+### Added
+- Initial release of Vortix VPN Manager
+- TUI dashboard with real-time network telemetry
+- WireGuard profile support (.conf files)
+- OpenVPN profile support (.ovpn files)
+- Quick slots (1-5) for favorite connections
+- Profile import via TUI (`i` key) and CLI (`vortix import`)
+- Self-update command (`vortix update`)
+- IPv6 leak detection
+- DNS leak detection
+- Insecure protocol detection (HTTP, FTP, Telnet)
+- Live throughput monitoring (upload/download speeds)
+- Connection uptime tracking
+- Nordic Frost color theme
+- Keyboard-driven interface with help overlay (`?` key)
+
+### Security
+- Config files stored with 600 permissions
+- Root privilege requirement for network interface management
+
+[Unreleased]: https://github.com/Harry-kp/vortix/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/Harry-kp/vortix/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vortix Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,343 @@
+# Vortix
+
+[![Crates.io](https://img.shields.io/crates/v/vortix.svg)](https://crates.io/crates/vortix)
+[![Downloads](https://img.shields.io/crates/d/vortix.svg)](https://crates.io/crates/vortix)
+[![CI](https://github.com/Harry-kp/vortix/actions/workflows/ci.yml/badge.svg)](https://github.com/Harry-kp/vortix/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![macOS](https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=white)](https://github.com/Harry-kp/vortix)
+[![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Harry-kp/vortix)
+[![Rust](https://img.shields.io/badge/Rust-1.75+-orange?logo=rust)](https://www.rust-lang.org/)
+[![GitHub Sponsors](https://img.shields.io/github/sponsors/Harry-kp?logo=github)](https://github.com/sponsors/Harry-kp)
+[![Homebrew](https://img.shields.io/badge/Homebrew-tap-orange?logo=homebrew)](https://github.com/Harry-kp/homebrew-tap)
+[![npm](https://img.shields.io/npm/v/@harry-kp/vortix?logo=npm)](https://www.npmjs.com/package/@harry-kp/vortix)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+[![GitHub Stars](https://img.shields.io/github/stars/Harry-kp/vortix?style=social)](https://github.com/Harry-kp/vortix)
+
+Terminal UI for WireGuard and OpenVPN with real-time telemetry and leak guarding.
+
+![Vortix Demo](assets/demo.gif)
+
+## Why Vortix?
+
+I wanted a single interface to:
+- See connection status, throughput, and latency at a glance
+- Detect IPv6/DNS leaks without running separate tools
+- Switch between VPN profiles without remembering CLI flags
+
+Existing options (`wg show`, NetworkManager, Tunnelblick) either lack real-time telemetry or require a GUI.
+
+| Feature | Vortix | GUI Clients | CLI-only |
+|---------|:------:|:-----------:|:--------:|
+| Memory usage | ~15MB | 200-500MB | ~5MB |
+| Startup time | <100ms | 2-5s | Instant |
+| Real-time telemetry | ✅ | ✅ | ❌ |
+| Leak detection | ✅ | Some | ❌ |
+| Kill switch | ✅ | ✅ | Manual |
+| Keyboard-driven | ✅ | ❌ | ✅ |
+| Works over SSH | ✅ | ❌ | ✅ |
+
+## Features
+
+- **WireGuard & OpenVPN** — Auto-detects `.conf` and `.ovpn` files
+- **Advanced Telemetry** — Real-time throughput, latency, **jitter**, and **packet loss**
+- **Geo-Location** — Instant detection of your exit IP's city and country
+- **Leak detection** — Monitors for IPv6 leaks and DNS leaks in real-time
+- **Kill Switch** — Built-in firewall management for maximum security
+- **Interactive Import** — Easily add new profiles directly within the TUI
+- **Config Viewer** — Inspect profile configurations directly within the TUI
+- **Keyboard-driven** — No mouse required
+
+## Requirements
+
+### Runtime dependencies
+
+| Dependency | macOS | Linux | Purpose |
+|------------|-------|-------|---------|
+| `curl` | Pre-installed | `apt install curl` | Telemetry and IP detection |
+| `openvpn` | `brew install openvpn` | `apt install openvpn` | OpenVPN sessions |
+| `wireguard-tools` | `brew install wireguard-tools` | `apt install wireguard-tools` | WireGuard sessions |
+| `iptables` or `nftables` | N/A (uses `pfctl`) | Pre-installed | Kill switch |
+| `iproute2` | N/A (uses `ifconfig`) | Pre-installed | Interface detection |
+
+> Vortix checks for missing tools at startup and shows a warning toast with install instructions.
+
+### Build dependencies (source installs only)
+
+- Rust 1.75+
+- macOS 12+ or Linux kernel 3.10+ (5.6+ recommended for native WireGuard)
+
+### Quick install commands
+
+**Ubuntu/Debian:**
+```bash
+sudo apt install curl wireguard-tools openvpn iptables iproute2
+```
+
+**Fedora/RHEL:**
+```bash
+sudo dnf install curl wireguard-tools openvpn iptables iproute
+```
+
+**Arch Linux** (only needed for source builds — `pacman -S vortix` handles deps automatically):
+```bash
+sudo pacman -S curl wireguard-tools openvpn iptables iproute2
+```
+
+> **DNS detection** uses `resolvectl` (systemd-resolved) as the primary method, with `nmcli` (NetworkManager) and `/etc/resolv.conf` as fallbacks. Non-systemd distros (Alpine, Void, Gentoo OpenRC) will use the `/etc/resolv.conf` fallback automatically.
+
+## Installation
+
+**Homebrew (macOS/Linux):**
+```bash
+brew install Harry-kp/tap/vortix
+```
+
+**npm/npx:**
+```bash
+npm install -g @harry-kp/vortix
+# or run directly without installing:
+npx @harry-kp/vortix
+```
+
+**From crates.io:**
+```bash
+cargo install vortix
+```
+
+**Arch Linux ([extra repo](https://archlinux.org/packages/extra/x86_64/vortix/)):**
+```bash
+pacman -S vortix
+```
+
+**Quick install (Binary):**
+```bash
+curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Harry-kp/vortix/releases/latest/download/vortix-installer.sh | sh
+```
+
+**Static binary (Linux):**
+
+Download the `x86_64-unknown-linux-musl` release from the [releases page](https://github.com/Harry-kp/vortix/releases). This is a statically linked binary (no glibc needed), but you still need the runtime dependencies above (curl, openvpn/wireguard-tools, etc.).
+
+**From source:**
+```bash
+git clone https://github.com/Harry-kp/vortix.git
+cd vortix
+cargo install --path .
+```
+
+### Linux: setting up sudo access
+
+Vortix needs root to manage VPN connections and firewall rules. On Linux, `sudo` uses a restricted PATH (`secure_path` in `/etc/sudoers`) that **does not include** `~/.cargo/bin/` — so `sudo vortix` will fail with `command not found`.
+
+**Fix (one-time):**
+```bash
+sudo ln -s ~/.cargo/bin/vortix /usr/local/bin/vortix
+```
+
+After this, `sudo vortix` works as expected.
+
+**Who is affected:**
+- `cargo install vortix` — yes
+- Shell installer (`curl | sh`) — yes
+- From source (`cargo install --path .`) — yes
+- `pacman -S vortix` (Arch) — **no**, installs to `/usr/bin/`
+- `brew install` (Homebrew) — **no**, installs to Homebrew prefix
+- `npm install -g` (npm) — **no**, installs to npm global bin
+- macOS — **no**, sudo preserves user PATH
+
+## Usage
+
+```bash
+sudo vortix              # Launch TUI (requires root for VPN operations)
+vortix import <file>     # Import a .conf or .ovpn profile
+vortix info              # Show config directory and version
+vortix update            # Self-update to latest release
+```
+
+### Keybindings
+
+| Key | Action |
+|-----|--------|
+| `Tab` | Cycle Focus (All Panels) |
+| `1-9` | Connect to Quick-Slot 1-9 |
+| `Enter` | Connect / Toggle Profile |
+| `d` | Disconnect Active Session |
+| `r` | Reconnect Active Session |
+| `i` | Import Profile (Direct) |
+| `v` | View Profile Configuration |
+| `y` | Copy Public IP to Clipboard |
+| `K` | Toggle Kill Switch (Shift+K) |
+| `z` | Toggle Zoom View (Panel) |
+| `x` | Open Action Menu (Contextual) |
+| `b` | Open Bulk Menu |
+| `Del` | Delete Profile (Sidebar) |
+| `q` | Quit Application |
+
+## Configuration
+
+### Config directory
+
+By default, vortix stores profiles, auth credentials, and logs in `~/.config/vortix/`.
+
+Override via CLI flag or environment variable:
+
+```bash
+sudo vortix --config-dir /path/to/custom/dir
+# or
+export VORTIX_CONFIG_DIR=/path/to/custom/dir
+sudo vortix
+```
+
+Precedence: `--config-dir` flag > `VORTIX_CONFIG_DIR` env var > default path.
+
+When running with `sudo`, vortix automatically resolves the invoking user's home directory (via `SUDO_USER`), so config files live in *your* home, not `/root/`.
+
+### Directory structure
+
+```
+~/.config/vortix/
+├── profiles/                 VPN configuration files
+│   ├── work.conf             WireGuard profile
+│   └── office.ovpn           OpenVPN profile
+├── auth/                     Saved OpenVPN credentials
+│   └── office                Username + password for "office" profile
+├── run/                      OpenVPN runtime files (temporary)
+│   ├── office.pid            Daemon PID (source of truth for disconnect)
+│   └── office.log            Raw daemon output (monitors connect/failure)
+├── logs/                     Application logs (daily rotation)
+│   └── 2026-02-09.log        Same content as the TUI Logs panel
+├── config.toml               User settings (optional, see below)
+├── metadata.json             Profile metadata (last used, sort order)
+└── killswitch.state          Kill switch state for crash recovery
+```
+
+All files and directories are owned by your user account, even when vortix runs under `sudo`. You can read, modify, or delete anything here without elevated privileges.
+
+| Path | Mode | Description |
+|------|:----:|-------------|
+| `profiles/` | `600` | Your `.conf` and `.ovpn` files. Added via `vortix import` or the TUI. |
+| `auth/` | `600` | Saved OpenVPN username/password pairs. One file per profile. |
+| `run/` | `644` | **OpenVPN only.** PID and log files created during a VPN session. The `.pid` file identifies which daemon to kill; the `.log` is polled for success/failure. Cleaned up on disconnect. WireGuard doesn't use this. |
+| `logs/` | `644` | Application session logs (daily rotation, configurable size/retention). Not the raw OpenVPN output in `run/`. |
+| `config.toml` | `644` | Optional user settings. Only exists if you create it manually (see below). |
+| `metadata.json` | `644` | Internal bookkeeping (last used, sort order). Auto-managed. |
+| `killswitch.state` | `644` | Persists kill switch mode across crashes. Auto-managed. |
+
+### Config file
+
+Create `~/.config/vortix/config.toml` to customize settings. All fields are optional -- missing fields use defaults:
+
+```toml
+# --- Timing ---
+
+# UI refresh rate in milliseconds (default: 1000)
+tick_rate = 1000
+
+# Telemetry polling interval in seconds (default: 30)
+telemetry_poll_rate = 30
+
+# HTTP API timeout in seconds (default: 5)
+api_timeout = 5
+
+# Ping timeout in seconds (default: 2)
+ping_timeout = 2
+
+# OpenVPN connection timeout in seconds (default: 20)
+connect_timeout = 20
+
+# Max seconds to wait for a VPN disconnect before force-killing (default: 30)
+disconnect_timeout = 30
+
+# --- Logging ---
+
+# Minimum log level shown in the TUI event log: "debug", "info", "warning", "error" (default: "info")
+log_level = "info"
+
+# Maximum log entries kept in the TUI event log (default: 1000)
+max_log_entries = 1000
+
+# Log file rotation size in bytes (default: 5242880 = 5 MB)
+log_rotation_size = 5242880
+
+# Days to retain old log files (default: 7)
+log_retention_days = 7
+
+# --- OpenVPN ---
+
+# OpenVPN daemon verbosity level, --verb flag, range 0-11 (default: "3")
+openvpn_verbosity = "3"
+
+# --- Telemetry endpoints ---
+
+# Ping targets for latency measurement (tried in order)
+ping_targets = ["1.1.1.1", "8.8.8.8", "9.9.9.9", "208.67.222.222"]
+
+# IPv6 leak detection endpoints
+ipv6_check_apis = ["https://ipv6.icanhazip.com", "https://v6.ident.me", "https://api6.ipify.org"]
+
+# Primary IP/ISP API
+ip_api_primary = "https://ipinfo.io/json"
+
+# Fallback IP APIs
+ip_api_fallbacks = ["https://api.ipify.org", "https://icanhazip.com", "https://ifconfig.me/ip"]
+```
+
+## How It Works
+
+**Telemetry:** A background thread polls system network stats every second for throughput (macOS: `netstat -ib`, Linux: `/proc/net/dev`). Network quality (latency, jitter, loss) is calculated using multi-packet ICMP probes. Public IP, ISP, and Geo-location data are fetched via `ipinfo.io/json`.
+
+**Security (Kill Switch & Leak Detection):**
+- **Kill Switch:** Platform-native firewall integration. macOS uses PF (Packet Filter) via `pfctl`. Linux supports both `iptables` (with a dedicated `VORTIX_KILLSWITCH` chain) and `nftables` (with an atomic `vortix_killswitch` table) for clean teardown. Automatically blocks all non-VPN traffic when connection drops.
+- **IPv6 Leak:** Active monitoring via `api6.ipify.org`. Any IPv6 traffic detected while VPN is active triggers a leak warning.
+- **DNS Leak:** Monitors DNS configuration to ensure nameservers align with the secure tunnel (macOS: `scutil --dns` / `networksetup`, Linux: `resolvectl` / `nmcli` / `/etc/resolv.conf`).
+
+**WireGuard Integration:** macOS resolves interface names via `/var/run/wireguard/*.name`. Linux uses kernel WireGuard interfaces directly (`wg0`, `wg1`, etc.). Both platforms parse `wg show` for handshake timing, transfer stats, and endpoint metadata.
+
+**OpenVPN Integration:** Tracks session uptime and connection status via `ps` proc parsing. Interface detection uses `ifconfig` on macOS and `ip addr` on Linux.
+
+### Platform Notes
+
+| Feature | macOS | Linux |
+|---------|-------|-------|
+| Kill switch | `pfctl` (PF) | `iptables` or `nftables` |
+| Network stats | `netstat -ib` | `/proc/net/dev` |
+| Interface detection | `ifconfig` + `/var/run/wireguard/` | `ip addr` + `wg show` |
+| DNS detection | `scutil --dns`, `networksetup` | `resolvectl`, `nmcli`, `/etc/resolv.conf` |
+| Default VPN iface | `utun0` | `wg0` |
+| Tested distros | macOS 12+ | Ubuntu, Fedora, Arch |
+
+## Troubleshooting
+
+**Profiles missing after upgrade (Linux)**
+
+If you previously ran vortix with `sudo` and profiles were stored in `/root/.config/vortix/`, the app will offer a one-time migration prompt. Accept it to move your data to `~/.config/vortix/` under your real user account.
+
+If you declined migration and want to keep using the old path:
+
+```bash
+sudo vortix --config-dir /root/.config/vortix
+```
+
+**Permission denied errors**
+
+If config files are owned by root, fix ownership:
+
+```bash
+sudo chown -R $(whoami) ~/.config/vortix/
+```
+
+## Development
+
+```bash
+cargo build         # Build binary
+cargo test          # Run unit/integration tests
+cargo clippy        # Enforce code quality (Fail-fast via pre-commit)
+```
+
+## Featured In
+
+- [Terminal Trove](https://terminaltrove.com/vortix/) — The $HOME of all things in the terminal
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=Harry-kp/vortix&type=Date)](https://star-history.com/#Harry-kp/vortix&Date)

package/binary-install.js

@@ -0,0 +1,212 @@
+const { createWriteStream, existsSync, mkdirSync, mkdtemp } = require("fs");
+const { join, sep } = require("path");
+const { spawnSync } = require("child_process");
+const { tmpdir } = require("os");
+
+const axios = require("axios");
+const rimraf = require("rimraf");
+const tmpDir = tmpdir();
+
+const error = (msg) => {
+  console.error(msg);
+  process.exit(1);
+};
+
+class Package {
+  constructor(platform, name, url, filename, zipExt, binaries) {
+    let errors = [];
+    if (typeof url !== "string") {
+      errors.push("url must be a string");
+    } else {
+      try {
+        new URL(url);
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    if (name && typeof name !== "string") {
+      errors.push("package name must be a string");
+    }
+    if (!name) {
+      errors.push("You must specify the name of your package");
+    }
+    if (binaries && typeof binaries !== "object") {
+      errors.push("binaries must be a string => string map");
+    }
+    if (!binaries) {
+      errors.push("You must specify the binaries in the package");
+    }
+
+    if (errors.length > 0) {
+      let errorMsg =
+        "One or more of the parameters you passed to the Binary constructor are invalid:\n";
+      errors.forEach((error) => {
+        errorMsg += error;
+      });
+      errorMsg +=
+        '\n\nCorrect usage: new Package("my-binary", "https://example.com/binary/download.tar.gz", {"my-binary": "my-binary"})';
+      error(errorMsg);
+    }
+
+    this.platform = platform;
+    this.url = url;
+    this.name = name;
+    this.filename = filename;
+    this.zipExt = zipExt;
+    this.installDirectory = join(__dirname, "node_modules", ".bin_real");
+    this.binaries = binaries;
+
+    if (!existsSync(this.installDirectory)) {
+      mkdirSync(this.installDirectory, { recursive: true });
+    }
+  }
+
+  exists() {
+    for (const binaryName in this.binaries) {
+      const binRelPath = this.binaries[binaryName];
+      const binPath = join(this.installDirectory, binRelPath);
+      if (!existsSync(binPath)) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  install(fetchOptions, suppressLogs = false) {
+    if (this.exists()) {
+      if (!suppressLogs) {
+        console.error(
+          `${this.name} is already installed, skipping installation.`,
+        );
+      }
+      return Promise.resolve();
+    }
+
+    if (existsSync(this.installDirectory)) {
+      rimraf.sync(this.installDirectory);
+    }
+
+    mkdirSync(this.installDirectory, { recursive: true });
+
+    if (!suppressLogs) {
+      console.error(`Downloading release from ${this.url}`);
+    }
+
+    return axios({ ...fetchOptions, url: this.url, responseType: "stream" })
+      .then((res) => {
+        return new Promise((resolve, reject) => {
+          mkdtemp(`${tmpDir}${sep}`, (err, directory) => {
+            let tempFile = join(directory, this.filename);
+            const sink = res.data.pipe(createWriteStream(tempFile));
+            sink.on("error", (err) => reject(err));
+            sink.on("close", () => {
+              if (/\.tar\.*/.test(this.zipExt)) {
+                const result = spawnSync("tar", [
+                  "xf",
+                  tempFile,
+                  // The tarballs are stored with a leading directory
+                  // component; we strip one component in the
+                  // shell installers too.
+                  "--strip-components",
+                  "1",
+                  "-C",
+                  this.installDirectory,
+                ]);
+                if (result.status == 0) {
+                  resolve();
+                } else if (result.error) {
+                  reject(result.error);
+                } else {
+                  reject(
+                    new Error(
+                      `An error occurred untarring the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
+                    ),
+                  );
+                }
+              } else if (this.zipExt == ".zip") {
+                let result;
+                if (this.platform.artifactName.includes("windows")) {
+                  // Windows does not have "unzip" by default on many installations, instead
+                  // we use Expand-Archive from powershell
+                  result = spawnSync("powershell.exe", [
+                    "-NoProfile",
+                    "-NonInteractive",
+                    "-Command",
+                    `& {
+                        param([string]$LiteralPath, [string]$DestinationPath)
+                        Expand-Archive -LiteralPath $LiteralPath -DestinationPath $DestinationPath -Force
+                    }`,
+                    tempFile,
+                    this.installDirectory,
+                  ]);
+                } else {
+                  result = spawnSync("unzip", [
+                    "-q",
+                    tempFile,
+                    "-d",
+                    this.installDirectory,
+                  ]);
+                }
+
+                if (result.status == 0) {
+                  resolve();
+                } else if (result.error) {
+                  reject(result.error);
+                } else {
+                  reject(
+                    new Error(
+                      `An error occurred unzipping the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
+                    ),
+                  );
+                }
+              } else {
+                reject(
+                  new Error(`Unrecognized file extension: ${this.zipExt}`),
+                );
+              }
+            });
+          });
+        });
+      })
+      .then(() => {
+        if (!suppressLogs) {
+          console.error(`${this.name} has been installed!`);
+        }
+      })
+      .catch((e) => {
+        error(`Error fetching release: ${e.message}`);
+      });
+  }
+
+  run(binaryName, fetchOptions) {
+    const promise = !this.exists()
+      ? this.install(fetchOptions, true)
+      : Promise.resolve();
+
+    promise
+      .then(() => {
+        const [, , ...args] = process.argv;
+
+        const options = { cwd: process.cwd(), stdio: "inherit" };
+
+        const binRelPath = this.binaries[binaryName];
+        if (!binRelPath) {
+          error(`${binaryName} is not a known binary in ${this.name}`);
+        }
+        const binPath = join(this.installDirectory, binRelPath);
+        const result = spawnSync(binPath, args, options);
+
+        if (result.error) {
+          error(result.error);
+        }
+
+        process.exit(result.status);
+      })
+      .catch((e) => {
+        error(e.message);
+        process.exit(1);
+      });
+  }
+}
+
+module.exports.Package = Package;