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.8 curl -fsSL https://release.zeloscloud.io/cli/install.sh | bash

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

Manual Install

Download the binary for your platform, extract, and install it to ~/.zelos/bin (the same location the quick install uses — no sudo required):

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-aarch64-apple-darwin.tar.gz | tar xz
mkdir -p ~/.zelos/bin && mv zelos ~/.zelos/bin/

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-x86_64-apple-darwin.tar.gz | tar xz
mkdir -p ~/.zelos/bin && mv zelos ~/.zelos/bin/

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-x86_64-unknown-linux-gnu.tar.gz | tar xz
mkdir -p ~/.zelos/bin && mv zelos ~/.zelos/bin/

curl -fsSL https://release.zeloscloud.io/cli/latest/zelos-aarch64-unknown-linux-gnu.tar.gz | tar xz
mkdir -p ~/.zelos/bin && mv zelos ~/.zelos/bin/

Download and extract manually:

  1. Download zelos-x86_64-pc-windows-msvc.zip
  2. Extract zelos.exe
  3. Move it to %USERPROFILE%\.zelos\bin, or another directory on your PATH

On macOS / Linux, add ~/.zelos/bin to your PATH if it isn't already:

echo 'export PATH="$HOME/.zelos/bin:$PATH"' >> ~/.profile && source ~/.profile

Verify

zelos version

Shell Completions

The installer automatically sets up shell completions. If you installed manually, or want to regenerate them, run:

zelos completions bash --install

zelos completions zsh --install

zelos completions fish --install

Fish picks up completions automatically from ~/.config/fish/completions/.

zelos completions powershell --install

--install updates your shell startup file automatically when the shell needs an explicit activation step. If you intentionally disabled shell startup changes, the command prints the exact snippet to add manually.

You can also print completions to stdout (e.g. for piping):

zelos completions bash    # or zsh, fish, powershell, elvish

Commands

See the CLI Reference for full command documentation, flags, and usage examples.

Configuration

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

Environment Variable Description
ZELOS_AGENT_URL Default agent endpoint for --host (default localhost:2300); an explicit --host wins
RUST_LOG Override log level (e.g. RUST_LOG=debug)

Uninstall

Remove the binary, configuration, and completions:

rm -rf ~/.zelos
rm -f ~/.config/fish/completions/zelos.fish
rm -f ~/.config/elvish/lib/zelos-completions.elv

This removes the binary too, since both the quick and manual installs place it under ~/.zelos/bin. Also remove the ~/.zelos/bin line the installer added to your shell profile (~/.profile, ~/.bashrc, or ~/.zshrc).

Remove the binary, configuration, and completions:

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

🚀 What's Next?