Install

The CLI ships as a single binary for macOS and Linux on x86_64 and arm64. There is nothing else to install.

Install script

curl -fsSL https://helios.dev/install.sh | bash

The script does the following.

1. Detects your operating system and CPU.
2. Downloads the matching binary from packages.heliosapp.com.
3. Verifies the SHA-256 checksum. It stops if the checksum does not match.
4. Moves the binary to /usr/local/bin/helios. It asks for sudo only if that folder is not writable.

To install a specific version, pass it to the script.

curl -fsSL https://helios.dev/install.sh | bash -s v1.2.3

To install somewhere else, set HELIOS_INSTALL_DIR first.

HELIOS_INSTALL_DIR="$HOME/.local/bin" bash -c "$(curl -fsSL https://helios.dev/install.sh)"

Build from source

The CLI is the @pangea/helios-cli package in the Helios repository. It builds with Bun.

cd apps/helios-cli
bun install
bun run build

The binary lands at dist/helios.

Check the install

helios version

This prints the version, commit, and build date.

helios doctor

This checks that your machine is ready. Run it if something looks wrong later.

Update

helios update

To check for a new version without installing it, add --check.

helios update --check

Shell completion

Generate a completion script for your shell and source it from your profile.

helios completion zsh

Next step

Run helios configure to sign in and pick a project.