OS Manuals

/usr/bin/wash

wasmCloud allows for simple, secure, distributed application development using WebAssembly components and capability providers.

From wasmcloud 2.12.1-r0 (os), captured 2026-11-09 by running wash --help (exit 0). permalink

The Wasm Shell (wash) for developing and publishing Wasm components

Usage: wash [OPTIONS] [COMMAND]

Commands:
  build       Build a Wasm component
  completion  Generate shell completions
  config      View configuration for wash
  dev         Start a development server for a Wasm component
  inspect     Inspect a Wasm component's embedded WIT
  host        Act as a Host
  new         Create a new project from a template or git repository
  oci         Push or pull Wasm components to/from an OCI registry
  update      Update wash to the latest version
  wit         Manage WIT dependencies
  help        Print this message or the help of the given subcommand(s)

Options:
  -o, --output <OUTPUT>
          Specify output format (text or json)

          [default: text]

  -l, --log-level <LOG_LEVEL>
          Set the opentelemetry log level (trace, debug, info, warn, error)

          [default: INFO]

      --verbose
          Enable verbose output

      --non-interactive
          Run in non-interactive mode: skip terminal checks for host exec and accept the default
          answer for any confirmation prompts. Automatically enabled when stdin is not a TTY

      --user-config <USER_CONFIG>
          Path to user configuration file

  -C <PROJECT_PATH>
          Path to the project directory

          [default: /tmp]

      --meters <METERS>
          What to measure about guests: `off`, `duration`, or `fuel`.

          `duration` reports how many invocations there were, how many failed and how long they
          took, for two clock reads a call — the default, because it is what an operator needs first
          and costs the guest nothing. `fuel` adds an exact count of the operations a guest
          executed, at the price of a counter compiled into every block of its code.

          [default: duration]

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version
Options (9)
OptionDescriptionSource
-o, --output OUTPUTSpecify output format (text or json)help
-l, --log-level LOG_LEVELSet the opentelemetry log level (trace, debug, info, warn, error)help
--verboseEnable verbose outputhelp
--non-interactiveRun in non-interactive mode: skip terminal checks for host exec and accept the default answer for any confirmation prompts.help
--user-config USER_CONFIGPath to user configuration filehelp
-C PROJECT_PATHPath to the project directoryhelp
--meters METERSWhat to measure about guests: `off`, `duration`, or `fuel`.help
-h, --helpPrint help (see a summary with '-h')help
-V, --versionPrint versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.