Installation
NetsCLI publishes command-line binaries and desktop installers through GitHub Releases. The CLI/TUI binary is named netscli. The desktop app is distributed as NetsCLI Desktop.
Recommended installs
Section titled “Recommended installs”| Platform | Recommended path | Installs |
|---|---|---|
| Windows | winget install fstubner.netscli | CLI and TUI |
| Windows | winget install fstubner.netscli.gui | Desktop app |
| macOS | Homebrew or install script | CLI and TUI |
| Linux | Install script, Homebrew, AUR, or release artifact | CLI and TUI |
| Rust users | cargo install netscli | CLI and TUI from crates.io |
Windows
Section titled “Windows”Use winget for the hash-verified install path:
winget install fstubner.netscliThe desktop app is distributed separately:
winget install fstubner.netscli.guiDirect Windows installers are attached to GitHub Releases. They are not Authenticode-signed yet, so Windows may show a publisher warning when installing outside winget. The winget manifests verify release asset hashes.
Use Homebrew when available:
brew tap fstubner/tap && brew install netscliOr use the install script:
curl -fsSL https://raw.githubusercontent.com/fstubner/netscli/main/scripts/install.sh | bashDesktop .dmg artifacts are attached to GitHub Releases where the release workflow publishes them. macOS may require the usual first-run approval for unsigned or independently distributed apps.
Use the install script:
curl -fsSL https://raw.githubusercontent.com/fstubner/netscli/main/scripts/install.sh | bashInstall with Homebrew on Linux when you use Linuxbrew:
brew tap fstubner/tap && brew install netscliOn Arch-based systems with an AUR helper:
yay -S netscli-binRelease artifacts may include Linux CLI binaries and desktop packages such as .deb or .AppImage, depending on the release.
If Rust is installed:
cargo install netscliCargo installs the CLI/TUI binary. It does not install the desktop app.
Updating
Section titled “Updating”Use the same package manager you installed with.
Update the CLI and TUI on Windows:
winget upgrade fstubner.netscliUpdate the desktop app on Windows:
winget upgrade fstubner.netscli.guiUpdate a Homebrew install:
brew upgrade netscliFor direct release artifacts, download the latest GitHub release and replace the previous install with the matching package for your platform.
Packet capture requirements
Section titled “Packet capture requirements”Normal scan, discovery, DNS, ARP, ping, trace, and interface workflows do not require packet-capture libraries.
Packet capture is the exception:
- Windows requires Npcap at runtime.
- Linux requires libpcap and appropriate capture permissions.
- macOS requires libpcap availability and may require capture permissions.
If a build does not include packet capture support, the desktop app hides Packet Capture and the CLI omits that command path. If support is included but the runtime library is missing, only packet capture is unavailable.