HENGSHI CLI Installation & Upgrade

Access path

HENGSHI CLI is now available through public download links for Linux, macOS, and Windows.

• Installer script (Linux / macOS): https://download.hengshi.com/cli/install.sh
• Installer script (Windows PowerShell): https://download.hengshi.com/cli/install.ps1
• GitHub Releases (manual downloads and release notes): https://github.com/hengshi/cli/releases

Initial installation and later upgrades reuse the same installer entry points above. If you need a fixed version package, use GitHub Releases instead of constructing a versioned download.hengshi.com URL.

NOTE

Starting with 2.0.0, the public command name is hbi, and the preferred environment-variable prefix is HBI_*. To avoid confusion, this page does not document legacy naming/compatibility details; follow the behavior of your installed package and upgrade scripts if you still have older names in your environment.

Recommended installation paths

Option 1: Use the official installer script

Linux / macOS:

curl -fsSL https://download.hengshi.com/cli/install.sh | sh

Windows PowerShell:

irm https://download.hengshi.com/cli/install.ps1 | iex

If you want to install the CLI and the official bundled skills in one step, pass the installer flags directly:

curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills
curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills --agent openclaw
curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills --agent claude-code --agent github-copilot

Windows PowerShell:

& ([scriptblock]::Create((irm https://download.hengshi.com/cli/install.ps1))) -WithSkills -Agent openclaw

If --agent is omitted, the installer auto-detects existing local agent config directories from the bundled supported-agents.tsv. If --agent is provided, it installs directly into that agent's global skill directory.

Option 2: Download release assets from GitHub Releases

If you need fixed-version rollout, offline delivery, or package mirroring, download the matching release assets from GitHub Releases:

https://github.com/hengshi/cli/releases

Each release page provides:

• platform-specific binary archives
• checksums.txt
• release notes

Verify the installation

At minimum, run:

hbi --version
hbi --help
hbi auth status

If hbi --version works and auth status only says that you are not logged in yet, the CLI itself is installed correctly. The usual next step is to pick the target host explicitly and authenticate:

export HBI_HOST="<your-hengshi-sense-instance>"
hbi auth login --device-login

For automation, or for runtimes that should avoid OS keyring prompts, prefer explicit HBI_HOST + HBI_CLIENT_ID + HBI_CLIENT_SECRET and set HBI_DISABLE_KEYRING=true when the runtime should not use the system keyring. See Authentication & Connection for the full host/auth decision table.

Upgrade guidance

Upgrading does not require a separate "upgrade download" URL. If the current CLI install came from the official installer, prefer the built-in updater commands:

• Check whether a newer public version exists: hbi update --check
• Upgrade to the latest public release: hbi update
• Upgrade the CLI and refresh bundled skills together: hbi update --with-skills
• Upgrade or switch to a specific public version: hbi update --version <version>
• Refresh official skills only: hbi update --version <current-version> --with-skills

hbi update --check
hbi update
hbi update --with-skills

hbi update --check is auth-free; it does not require saved credentials, HBI_TOKEN / --token, or instance selection. If the command says the current install is not updater-managed yet, rerun the official installer once first.

If you already installed the CLI through the installer script, or you need to repair an environment that does not have local updater state yet, you can still rerun the same installer command:

curl -fsSL https://download.hengshi.com/cli/install.sh | sh

Windows PowerShell:

irm https://download.hengshi.com/cli/install.ps1 | iex

If you need a specific version package, open https://github.com/hengshi/cli/releases and choose the matching release instead of manually constructing a versioned download.hengshi.com directory URL.

If you only want to refresh the official bundled skills through the installer path without changing the CLI binary, rerun the installer with --with-skills:

curl -fsSL https://download.hengshi.com/cli/install.sh | sh -s -- --with-skills

After upgrading, run:

hbi --version
hbi auth status --output json

If you run into inconsistent command entrypoints after upgrading, rerun the official installer to let it take over the installation, and standardize on hbi as the command entrypoint.