Installation

Shield CLI supports multiple installation methods. Choose the one that fits your operating system.

macOS

Homebrew (Recommended)

brew tap fengyily/tap
brew install shield-cli

One-Liner

curl -fsSL https://raw.githubusercontent.com/fengyily/shield-cli/main/install.sh | sh

Windows

Scoop (Recommended)

scoop bucket add shield https://github.com/fengyily/scoop-bucket
scoop install shield-cli

PowerShell One-Liner

irm https://raw.githubusercontent.com/fengyily/shield-cli/main/install.ps1 | iex

Linux

One-Liner

curl -fsSL https://raw.githubusercontent.com/fengyily/shield-cli/main/install.sh | sh

Debian / Ubuntu

sudo dpkg -i shield-cli_<version>_linux_amd64.deb

RHEL / CentOS

sudo rpm -i shield-cli_<version>_linux_amd64.rpm

Download packages from GitHub Releases.

China Mirror

If GitHub is slow in your region, use the jsDelivr CDN mirror:

curl -fsSL https://cdn.jsdelivr.net/gh/fengyily/shield-cli@main/install.sh | sh

Build from Source

git clone https://github.com/fengyily/shield-cli.git
cd shield-cli
go build -o shield .

Requires Go 1.25.0 or later.

Verify Installation

shield --version

If you see a version number, the installation was successful.

Supported Platforms

OS	Architectures
macOS	amd64, arm64 (Apple Silicon)
Linux	amd64, arm64, 386, armv7
Windows	amd64, arm64, 386

Next Steps

• Quick Start