ZergBoard CLI

npm install -g @zergai/zergboard
zergboard --version
zb --help
zb login --api-token-stdin
zb orgs

zergboard and zb run the same native client. Requires Node.js 22 or later on macOS/Linux arm64 or x64. All four binaries are bundled; no install script, Go compiler, or separate binary download is required. Windows is not supported.

Manage boards, cards, repositories, knowledge, evidence, workspace operations, and the terminal UI. Server authorization still applies. Review targets before running modifying commands. See zb help for available commands.

Existing profiles remain in ~/.zergboard/zb.json. Use ZB_CONFIG_PATH to select an isolated configuration and ZB_BASE_URL to select your server. Supply tokens through stdin or existing credential configuration, not shell history.

First-party code remains proprietary (UNLICENSED). Bundled dependencies retain their licenses, included in THIRD_PARTY_NOTICES.txt.

Updating the npm CLI

Run zergboard update or zergboard --update to install a newer npm release. zergboard update --check prints JSON without installing. The installed channel is preserved (dev, next, or latest); select a channel explicitly with update --channel dev|next|latest. Updates never downgrade.

Startup checks only notify on stderr when it is a terminal, never prompt or install, and are cached for one hour. CI, redirected stderr, and help/version requests skip checks. Set ZERGAI_NO_UPDATE_CHECK=1 to disable startup checks. Self-installation requires the matching macOS/Linux global npm prefix; local, linked, npx, or other package-manager installs must use their original manager. Existing releases need one ordinary npm upgrade before these commands exist.

See shared updater policy for installation safety, channel switching, and packaging details.