Installation

Requirements

Linux: x86_64 or arm64
macOS: Apple Silicon (M1+). Intel Macs should use the pip install method.
Windows: x86_64
Python: 3.10+ (only required for pip install or build from source)

Install

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh | sh

The script auto-detects your OS and architecture, downloads the correct binary, verifies the SHA256 checksum, and installs to ~/.local/bin/xpoz-cli.Override the install directory or pin a specific version:

XPOZ_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh | sh

XPOZ_VERSION=1.2.0 curl -fsSL https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.sh | sh

Ensure ~/.local/bin is in your PATH. Add export PATH="$HOME/.local/bin:$PATH" to your shell profile if needed.

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/XPOZpublic/xpoz-cli/main/install.ps1 | iex

Installs to %LOCALAPPDATA%\xpoz-cli\xpoz-cli.exe. The script adds this directory to your user PATH automatically.

Available on macOS and Linux:

brew install XPOZpublic/xpoz/xpoz-cli

Or add the tap first, then install:

brew tap XPOZpublic/xpoz
brew install xpoz-cli

Update to the latest version:

brew upgrade xpoz-cli

Works on any platform with Python 3.10+:

pip install xpoz-cli

This is the recommended method for macOS Intel, which does not have a pre-built binary.

Update to the latest version:

pip install --upgrade xpoz-cli

Available on Windows:

winget install Xpoz.XpozCli

Update to the latest version:

winget upgrade Xpoz.XpozCli

Download the binary for your platform from GitHub Releases:

Platform	File
Linux x86_64	`xpoz-cli-linux-amd64`
Linux arm64	`xpoz-cli-linux-arm64`
macOS Apple Silicon	`xpoz-cli-macos-arm64`
Windows x86_64	`xpoz-cli-windows-amd64.exe`

Every release includes a SHA256SUMS file. Verify the download:

sha256sum -c SHA256SUMS --ignore-missing

Make the binary executable and move it to your PATH:

chmod +x xpoz-cli-linux-amd64
mv xpoz-cli-linux-amd64 ~/.local/bin/xpoz-cli

macOS Intel is not available as a pre-built binary. Use pip install xpoz-cli instead.

Requires Python 3.10+ and pip:

pip install xpoz pyinstaller
pyinstaller --onefile --name xpoz-cli xpoz_cli.py

The compiled binary will be in the dist/ directory.

Verify Installation

xpoz-cli --version

Next Steps

Authentication

Usage

Learn about platforms, commands, and global flags.

​Requirements

​Install

​Verify Installation

​Next Steps

Authentication

Usage

Requirements

Install

Verify Installation

Next Steps