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 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

Usage: zelos [OPTIONS] <COMMAND>

Commands:
  status       Print Zelos system status
  login        Login to Zelos Cloud
  logout       Logout from Zelos Cloud
  actions      List, execute, and inspect agent actions
  agent        Inspect and configure the Zelos agent
  extensions   Manage Zelos extensions
  layouts      Manage Zelos layouts
  live         Interact with live agent data
  trace        Trace file operations
  tools        Inspect and call Zelos agent tools (experimental, local dogfood only)
  update       Update the Zelos CLI to the latest version
  version      Print version
  completions  Generate or install shell completions
  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 (see a summary with '-h')
  -V, --version     Print version

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
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?