CLI Overview

The ZERG CLI is a standalone LuaJIT binary (321KB) with 55+ 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
status	zerg status	Server health and status
models	zerg models	List available models
inference	start, stop, status	LLM inference management
workers	list, spawn, kill	Agent worker management
workflow	list, start, show, cancel, tree	Multi-step workflows
bg-workers	start, list, status, logs, kill	Background workers
sessions	list, resume	Session management
memory	store, list, search, delete	Agent memory
schedules	create, list, delete	Job scheduling
login / logout	zerg login, zerg logout	Authentication

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