ailoha.
Home/ Docs/ Install the CLI

Installing the Ailoha CLI

The Ailoha CLI ships as a self-contained, AOT-compiled native binary for every supported platform. No .NET SDK required on the target machine.

Quick install

macOS / Linux (bash)

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

Windows (PowerShell)

iex "& { $(irm https://ailoha.dev/install.ps1) }"

By default the installer:

  1. Detects your runtime identifier (RID) — e.g. osx-arm64, linux-x64, win-x64.
  2. Downloads the matching archive from the latest GitHub Release.
  3. Verifies the SHA-512 checksum.
  4. Extracts to ~/.ailoha/bin (Unix) or %USERPROFILE%\.ailoha\bin (Windows).
  5. Updates your shell init files (or PATH env var on Windows) so ailoha is on PATH for new shells.

Re-run the same command to upgrade in place — or use ailoha update --self.

Channels

Both the installer scripts and ailoha update --self support three channels:

ChannelSource tagUse when
releaselatest GitHub ReleaseProduction / default
stagingtags matching rc-*Pre-release validation
devtags matching dev-*Daily builds / contributors

Switch channels with --quality:

curl -fsSL https://ailoha.dev/install.sh | bash -s -- --quality dev
& { $(irm https://ailoha.dev/install.ps1) } -Quality dev

More options

For custom install paths, version pinning, manual archive downloads (per-RID), checksum verification, and the full flag reference, continue with the sections below.

Next steps

Once installed, run ailoha init in your project to wire AI-agent skills, or jump to a platform guide: