Downloads

Zeltro comes in two pieces. The CLI does the work, and the app is a desktop front end that runs on top of it. The app is released as packages on the releases page: a Windows Setup .exe, .deb, .rpm and pacman packages for Linux (x86_64), and Mac apps for Apple Silicon and Intel, installed through Homebrew. Only the newest release is kept there.

Run the commands below as your normal user, not as root.

The Zeltro app (and the CLI with it)#

Linux

curl -fsSL https://dist.canebaycomputers.com/zeltro/ubuntu | bash

The same command works on Ubuntu/Debian, Fedora/RHEL and Arch (the fedora and arch links go to the same installer). It installs the CLI first if zeltro is missing, then adds Zeltro's signed package repository (packages.zeltro.ai) and installs the app from it with apt, dnf or pacman. The app then appears in your applications menu. Afterwards, log out and back in once so your user can use Docker.

Updates arrive with your system's own updates (apt upgrade, dnf upgrade, pacman -Syu), like any other package. To add the repository by hand instead, see the zeltro-releases README. On Arch the installer runs pacman -Syu, which also upgrades the rest of the system, because Arch doesn't support partial upgrades.

Windows

Download the installer from zeltro.ai/download/windows. It is a normal Setup .exe (beta) that installs for your account only, so it needs no admin rights. It is not code-signed yet, so Windows may say it "protected your PC": choose More info → Run anyway. See Windows below for how to run your projects once it is installed.

macOS (Apple Silicon and Intel, macOS 12 or later)

curl -fsSL https://dist.canebaycomputers.com/zeltro/mac | bash

It installs the CLI first if zeltro is missing (with the Xcode Command Line Tools, Homebrew and Docker Desktop if any of those are missing), then the app from Zeltro's Homebrew tap. If you already have Homebrew and the CLI, you can install the app directly:

brew install --cask canebaycomputers/zeltro/zeltro

Update with Updates in the app, or brew upgrade --cask zeltro.

After installing#

On first launch the app asks you to accept its license terms, shows a short setup form and runs zeltro configure for you. Running zeltro configure in a terminal works too.

Upgrading from 1.0.0-beta.4 or earlier: those builds can't update themselves to beta.5. Install beta.5 over the old one the same way; your settings are kept.

What's in it#

Create with AI, the full app library, new project and clone, start/stop of the shared services, embedded tabbed terminals for AI sessions, and a Settings panel with AI agent configuration and a theme picker. Five themes ship: Retro (the default), Dark, Light, Matrix and Zeltro. Each has its own 16-colour terminal palette, so output stays readable, including on Light.

Windows#

On Linux the app drives a Zeltro on the same machine. On Windows, Zeltro itself has to run in Linux, and there are two ways to do that:

  • Another machine over SSH. This works today. The app drives Zeltro on a Linux box, a Mac, a Raspberry Pi or an EC2 instance. Add them under Settings → Remotes → Hosts. Each host needs Zeltro already installed and configured. Projects, containers and files live on the host that runs them.
  • This PC, through WSL2. In preview. The app's own setup for running Zeltro in WSL2 on the same PC is still in testing.

Remote hosts work from Linux too.

Zeltro CLI only#

If you don't want the app:

Linux

curl -fsSL https://dist.canebaycomputers.com/zeltro/cli/ubuntu | bash

For Fedora or Arch, replace ubuntu at the end of the link with fedora or arch.

macOS

curl -fsSL https://dist.canebaycomputers.com/zeltro/cli/mac | bash

This installs the Xcode Command Line Tools, Homebrew and Docker Desktop if any of them are missing.

Windows

See Installation → Windows.

Then run zeltro configure once. For supported distro versions and the other details, see Installation.

The CLI short links redirect to the install-<os>.sh scripts in the zeltro-cli repository; the app links go to the installers in zeltro-releases.

Versions#

zeltro --version reports the CLI version. The app's About panel shows both.

The CLI and the app have separate version numbers, and they aren't expected to match. The app checks what the installed CLI can do instead of comparing versions, and it hides any feature the CLI can't support. An older CLI loses individual features rather than failing outright. You can upgrade either one on its own.

Source and licensing#

The command line tool is open source under the MIT licence: CaneBayComputers/zeltro-cli.

The desktop app is proprietary. It's free for personal use. A business using it, including for paid client work, needs a lifetime commercial license, paid once, covering everyone in the business and every future version. There's no account to create either way, and you bring and pay for your own AI agent. The app sends usage counts and scrubbed error reports, and our servers record the IP address they come from; see what it collects.

Spotted a mistake? Edit this page on GitHub.