rialoman

Rialoman is the release and toolchain manager for the Rialo network. It installs Rialo releases and allows switching between them by keeping shims in the PATH in sync with the active release.

Rialoman uses the following directory layout to manage the installations:

$RIALO_HOME (default: $XDG_DATA_HOME/rialo or $HOME/.local/share/rialo)
  bin/         # shims added to PATH
  releases/    # channel/version directories
  toolchains/  # compiler toolchains
  downloads/   # cached tarballs + manifests (planned)
  tmp/         # staging for atomic installs
  current.json # currently active release pointer

Installation

You can install rialoman via cargo or using the hosted installer script:

Option A: cargo install

cargo install rialoman

Option B: curl installer

curl -fsSL https://rialo-artifacts.s3.us-east-2.amazonaws.com/rialoman/stable/install.sh | bash

The installer downloads the prebuilt rialoman binary for Linux (amd64/arm64) or macOS (arm64), installs it into $RIALO_HOME/bin, and optionally appends the PATH snippet to existing shell profiles (supports Bash, Zsh).

Examples

Installing/Uninstalling the CLI

rialoman install stable@latest
rialoman uninstall stable@0.0.1

rialoman install commit@830b4ee6

Switching versions

# Explicit version
rialoman use stable@0.1.0

# "commit" channel shorthand
rialoman use 830b4ee6

Inspection

rialoman list         # shows installed releases, marks the current one
rialoman current      # prints channel@version
rialoman which rialo  # resolves a binary within the current release