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

      • CLI reference

      The ash CLI is a machine interface. Successful output and error diagnostics use stable ASON, with no human help page, color, progress bar, or interactive REPL.

      CommandInputOutput
      ash --versionNoneStable version string
      ash --build-infoNoneVersion, target, protocol, ASON, commit, and trust fingerprint
      ash asonBare ASON on stdinUnique canonical ASON
      ash runOne typed request on stdinOne final response
      ash rpcLength-framed stdin/stdoutHandshake and ordered response frames
      ash self status [--prefix PATH]Installation prefixCurrent/previous version and install state
      ash self check --candidate FILECandidate binaryHealth, version, and target
      ash self update [--prefix PATH] [--from DIR]Signed metadata or offline directoryActivation result
      ash self rollback [--prefix PATH]Installation stateRollback or scheduled result
      ash self recover [--prefix PATH]Installation journalRecovery result

      ash self replace is an internal Windows helper used by activation, not a normal Harness interface.

      Error contract

      Example:

      s:1
e{c}:
4

      Exit codes map stably to error classes. Callers should branch on ASON diagnostics and exit status, never localized text. Missing arguments and unknown commands return a usage-class machine error instead of printing help.

      Working directory

      File operations are confined to the startup workspace. Paths must use canonical logical form and cannot escape through lexical traversal, symbolic links, or Windows reparse points. exec never switches to an implicit host shell.