Installation Guide

PCLI2 ships as pre-built binaries for macOS (Intel and Apple Silicon), Linux (x86_64 and aarch64) and Windows (x86_64). No Rust toolchain is needed unless you build from source.

Table of Contents

• Installers
• Verifying the Installation
• Updating
• Building from Source
• Troubleshooting

Installers

macOS and Linux: shell installer

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/jchultarsky101/pcli2/releases/latest/download/pcli2-installer.sh | sh

The script installs pcli2 and pcli2-update into ~/.cargo/bin (or the directory it reports) and offers to add it to your PATH.

macOS and Linux: Homebrew

Homebrew 6 refuses formulae from taps it has not been told to trust, so the first step is a one-time brew trust (per machine and user account):

brew trust jchultarsky101/pcli2
brew install jchultarsky101/pcli2/pcli2

Without it, brew install and every later brew upgrade pcli2 stop with "Refusing to load formula jchultarsky101/pcli2/pcli2 from untrusted tap". Homebrew 5 has no such check, but the first upgrade after moving to Homebrew 6 will. In CI, set HOMEBREW_NO_REQUIRE_TAP_TRUST=1 instead of trusting interactively.

Windows: PowerShell installer

powershell -ExecutionPolicy Bypass -c "irm https://github.com/jchultarsky101/pcli2/releases/latest/download/pcli2-installer.ps1 | iex"

Windows: MSI

Download pcli2-x86_64-pc-windows-msvc.msi from the latest release and run it.

Archives

Every release also carries plain archives (.tar.xz for macOS and Linux, .zip for Windows) with the binary inside. Extract it and put it on your PATH.

Verifying the Installation

pcli2 --version
pcli2 --help

Shell completions and man pages are generated by the binary itself:

pcli2 completions zsh > ~/.zfunc/_pcli2     # or bash, fish, elvish, powershell
pcli2 man --output-dir ./man

Updating

PCLI2 prints a one-line hint on stderr when a newer release exists (at most once a day, in terminal sessions only). Set PCLI2_NO_UPDATE_CHECK=1 to turn it off.

Building from Source

Requires a Rust toolchain (1.88 or newer) and, on Linux, pkg-config, libssl-dev and cmake.

git clone https://github.com/jchultarsky101/pcli2.git
cd pcli2
cargo build --release
# The executable is target/release/pcli2

PCLI2 is not published on crates.io, so cargo install pcli2 does not work.

Troubleshooting

1. Command not found: the install directory is not on your PATH; the installer prints the directory it used.
2. An old version keeps running: which -a pcli2 (or where pcli2 on Windows) lists every copy on the PATH; remove the stale one.
3. Build failures from source: update Rust with rustup update stable.

If you are stuck, open an issue at GitHub Issues.