ailoha.
Home/ Docs/ Install the CLI

Installing the Ailoha CLI

The Ailoha CLI installer downloads the matching native package tarball for your platform using registry HTTP APIs. No Node.js or npm CLI is required.

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 the host OS and architecture.
  2. Resolves the matching native package, such as @ailoha/cli-win-x64, from npm registry metadata.
  3. Downloads the package tarball, verifies npm SHA-512 integrity metadata, and extracts package/bin under ~/.ailoha/bin (Unix) or %USERPROFILE%\.ailoha\bin (Windows).
  4. 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.

Channels

The installer scripts support three channels:

ChannelPackage sourceUse when
releaselatest tag from @ailoha on npmjs.comProduction / default
stagingnext tag from @ailoha on npmjs.comPre-release validation
devdev tag from @microsoft on GitHub PackagesDaily 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

The npm-global launcher remains supported as a fallback:

npm install -g @ailoha/cli

For custom install paths, version pinning, 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: