For AI agents: the complete documentation index is available at https://a3s-lab.github.io/ash/en/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/ash/en/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/ash/en/guide/install.md.
ash
  • English
  • next

      • Cross-platform installation

      ash ships Unix Shell and Windows PowerShell entry points under one installation contract. The installers support latest stable, pinned version, offline archive, custom directories, forced replacement, and uninstall.

      Pre-release trust boundary

      There is no supported signed binary release yet. The release commands below pass CI, but fail closed until the first signed Release is published. Use the Cargo path when you need to validate current source now.

      Linux

      Supports x86-64 and ARM64:

      curl --proto '=https' --tlsv1.2 -LsSf \
  https://raw.githubusercontent.com/A3S-Lab/ash/main/install.sh | sh

      macOS

      Supports Intel and Apple Silicon through the same Unix entry point:

      curl --proto '=https' --tlsv1.2 -LsSf \
  https://raw.githubusercontent.com/A3S-Lab/ash/main/install.sh | sh

      Windows

      Run in PowerShell 5.1 or newer:

      [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
irm https://raw.githubusercontent.com/A3S-Lab/ash/main/install.ps1 | iex

      Build from source

      This path needs a stable Rust toolchain and uses the repository lockfile:

      cargo install --git https://github.com/A3S-Lab/ash --locked a3s-ash

      A source install is for development validation. It is not a signed release and does not carry release-package provenance.

      Target matrix

      PlatformArchitectureTarget tripleArchive
      Linuxx86-64x86_64-unknown-linux-musl.tar.gz
      LinuxARM64aarch64-unknown-linux-musl.tar.gz
      macOSIntelx86_64-apple-darwin.tar.gz
      macOSApple Siliconaarch64-apple-darwin.tar.gz
      Windowsx86-64x86_64-pc-windows-msvc.zip
      WindowsARM64aarch64-pc-windows-msvc.zip

      Common options

      BehaviorUnixWindows
      Pin version--version 0.1.0-Version 0.1.0
      Install prefix--prefix PATH-Prefix PATH
      Launcher directory--bin-dir PATH-BinDir PATH
      Do not change PATH--no-path-NoPath
      Replace current--force-Force
      Offline archive--archive FILE --sha256 HEX-Archive FILE -Sha256 HEX
      Uninstall--uninstall-Uninstall

      Linux and macOS default to ~/.local/share/ash with the launcher at ~/.local/bin/ash. Windows defaults to %LOCALAPPDATA%\Programs\ash.

      Both success and failure use ASON. The installer verifies target, version, archive shape, SHA-256, and embedded binary identity, and restores the previous installation if activation fails.