CLI Overview

The ZERG CLI is a standalone LuaJIT binary (321-377KB) with 54 commands for managing the ZERG platform.

Installation

cd zerg-cli
bash build/build.sh
# Binary at: zerg-cli/build/zerg
sudo cp zerg-cli/build/zerg /usr/local/bin/

Configuration

# Set up config with named profiles
zerg config set default.url https://api.nonsense.ws
zerg config set default.token <your-token>

# Or use environment variables
export ZERG_URL=https://api.nonsense.ws
export ZERG_TOKEN=<your-token>

Shell Completion

# Bash
zerg completion bash > /etc/bash_completion.d/zerg

# Zsh
zerg completion zsh > "${fpath[1]}/_zerg"

# Fish
zerg completion fish > ~/.config/fish/completions/zerg.fish

Command Groups

Group	Commands	Description
Health	health, metrics	Server health and metrics
Models	discover, list, ps, show, start, stop, stop-all, prepare	Model management
Inference	run, chat	OpenAI and Anthropic API completions
Workers	agents, spawn, kill, task, task-cancel, task-status	Agent worker management
Workflow	list, start, show, cancel, branch, tree, lineage	Multi-step workflows
Bg Workers	start, list, status, logs, kill	Background workers
Schedule	list, add, show, pause, unpause, run, delete	Job scheduling
Channels	channels, channel-add, channel-remove, channel-test, channel-send	Delivery channels
Recipes	recipe-list, recipe-show, recipe-run, recipe-reload	Workflow recipe templates
Skills	skills, skill-search, skill-register, skill-remove	Agent skill management
Keyring	keyring-test, keyring-set, keyring-get, keyring-delete	OS keyring integration
Plugin	plugin-eval, plugin-workers, plugin-spawn	Lua sandbox workers
ZMQ	zmq-workers, zmq-dispatch, zmq-status	ZMQ worker management
Cluster	cluster, catalog, join, leave	Cluster management
Circuits	circuits, circuits-reset	Circuit breaker management
Auth	login, logout	Authentication
Update	check, download, apply, rollback	Self-update management
Completion	completion	Shell completion scripts

Examples

# Check server status
zerg status

# List available models
zerg models

# Start inference
zerg inference start --model glm-5.1

# Start a workflow
zerg workflow start --template code-review

# Check background workers
zerg bg-workers list

# Login to a server
zerg login --url https://api.nonsense.ws --token <token>

# Get JSON output
zerg status --format json