OS Manuals

/usr/bin/wash

WAsmcloud SHell - a comprehensive command-line tool for wasmCloud development

From wash 0.39.0-r9 (os), captured 2026-11-05 by running wash --help (exit 0). permalink

Also provided by 1 other package version
_________________________________________________________________________________
                               _____ _                 _    _____ _          _ _
                              / ____| |               | |  / ____| |        | | |
 __      ____ _ ___ _ __ ___ | |    | | ___  _   _  __| | | (___ | |__   ___| | |
 \ \ /\ / / _` / __| '_ ` _ \| |    | |/ _ \| | | |/ _` |  \___ \| '_ \ / _ \ | |
  \ V  V / (_| \__ \ | | | | | |____| | (_) | |_| | (_| |  ____) | | | |  __/ | |
   \_/\_/ \__,_|___/_| |_| |_|\_____|_|\___/ \__,_|\__,_| |_____/|_| |_|\___|_|_|
_________________________________________________________________________________


Interact and manage wasmCloud applications, projects, and runtime environments

Usage: [OPTIONS] <COMMAND>

Build:
  new       Create a new project from a template or git repository
  build     Build (and sign) a wasmCloud component or capability provider
  dev       Start a developer loop to hot-reload a local wasmCloud component
  inspect   Inspect a Wasm component or capability provider for signing information and interfaces
  par       Create, inspect, and modify capability provider archive files
  wit       Create wit packages and fetch wit dependencies for a component

Run:
  up     Bootstrap a local wasmCloud environment
  down   Tear down a local wasmCloud environment (launched with wash up)
  app    Manage declarative applications and deployments (wadm)
  spy    Spy on all invocations a component sends and receives
  ui     Serve a web UI for wasmCloud

Iterate:
  get       Get information about different running wasmCloud resources
  start     Start a component or capability provider
  scale     Scale a component running in a host to a certain level of concurrency
  stop      Stop a component, capability provider, or host
  update    Update a component running in a host to newer image reference
  link      Link one component to another on a set of interfaces
  call      Invoke a simple function on a component running in a wasmCloud host
  label     Label (or un-label) a host with a key=value label pair
  config    Create configuration for components, capability providers and links
  secrets   Create secret references for components, capability providers and links

Publish:
  pull   Pull an artifact from an OCI compliant registry
  push   Push an artifact to an OCI compliant registry

Configure:
  completions   Generate shell completions for wash
  ctx           Manage wasmCloud host configuration contexts
  drain         Manage contents of local wasmCloud caches
  keys          Generate and manage signing keys
  claims        Generate and manage JWTs for wasmCloud components and capability providers
  plugin        Manage wash plugins

Options:
  -o, --output <OUTPUT>   Specify output format (text or json) [default: text]
  --experimental          Whether or not to enable experimental features [default: false]
  -h, --help              Print help
  -V, --version           Print version
Options (4)
OptionDescriptionSource
-o, --output OUTPUTSpecify output format (text or json) [default: text]help
--experimentalWhether or not to enable experimental features [default: false]help
-h, --helpPrint helphelp
-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.