Skip to content

Zelos CLI Installation

The Zelos CLI lets you interact with the Zelos App, Zelos Agent, or Zelos Cloud directly from the terminal.

Quick Install

curl -fsSL https://release.zeloscloud.io/cli/install.sh | bash

powershell -ExecutionPolicy ByPass -c "irm https://release.zeloscloud.io/cli/install.ps1 | iex"

# macOS / Linux
ZELOS_VERSION=0.1.0 curl -fsSL https://release.zeloscloud.io/cli/install.sh | bash

# Windows
powershell -ExecutionPolicy ByPass -c "$env:ZELOS_VERSION='0.1.0'; irm https://release.zeloscloud.io/cli/install.ps1 | iex"

Manual Install

Download the binary for your platform, extract, and place it somewhere on your PATH:

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-aarch64-apple-darwin.tar.gz | tar xz
sudo mv zelos /usr/local/bin/

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-x86_64-apple-darwin.tar.gz | tar xz
sudo mv zelos /usr/local/bin/

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv zelos /usr/local/bin/

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv zelos /usr/local/bin/

Download and extract manually:

  1. Download zelos-x86_64-pc-windows-msvc.zip
  2. Extract zelos.exe
  3. Move it to a directory on your PATH, or add its location to PATH

Verify

zelos version

Commands

Usage: zelos [OPTIONS] <COMMAND>

Commands:
  status      Print Zelos system status
  login       Login to Zelos Cloud
  logout      Logout from Zelos Cloud
  actions     Interact with the Actions gRPC service
  extensions  Manage Zelos Agent extensions
  trace       Trace file operations
  update      Update the Zelos CLI to the latest version
  version     Print version
  help        Print this message or the help of the given subcommand(s)

Options:
  -q, --quiet       Disable logging to console
  -v, --verbose...  Log to console, with increasing verbosity
  -h, --help        Print help
  -V, --version     Print version

Common Workflows

Login to Zelos Cloud:

zelos login

Check connection status:

zelos status

Merge trace files:

# Merge specific .trz files
zelos trace merge trace1.trz trace2.trz -o combined.trz

# Merge all .trz files in a directory
zelos trace merge ./traces/ -o combined.trz

# Mix files and directories
zelos trace merge ./traces/ extra.trz -o combined.trz

Manage extensions on a local agent:

# List installed extensions
zelos extensions list

# Install an extension
zelos extensions install acme/canbus-listener

# Start an extension
zelos extensions start acme-canbus-listener

Configuration

The CLI stores credentials in your system keyring and configuration in ~/.zelos/.

Environment Variable Description
RUST_LOG Override log level (e.g. RUST_LOG=debug)

Uninstall

Remove the binary and configuration:

rm -rf ~/.zelos

If you installed manually to /usr/local/bin:

sudo rm /usr/local/bin/zelos

Remove the binary and configuration:

Remove-Item -Recurse -Force "$HOME\.zelos"

🚀 What's Next?