wash

Create new WebAssembly component project

$ wash new component [project-name]

$ wash build

$ wash dev

$ wash up

$ wash down

$ wash push [registry.example.com/component:tag] [component.wasm]

$ wash inspect [component.wasm]

wash [options] command [arguments]

wash (wasmCloud Shell) is the comprehensive CLI for developing WebAssembly components and managing wasmCloud distributed applications. It provides tools for the complete development lifecycle from project scaffolding to deployment.
The CLI supports multi-language component development including Rust, Go, and TypeScript. Projects are built to WebAssembly components following the Component Model specification. The dev command provides a hot-reload development server for rapid iteration.
wasmCloud enables distributed applications where components communicate through capability providers for networking, storage, and other system services. wash manages local development environments and interacts with remote wasmCloud lattices.

-o format

Output format: text, json.

NATS server host.

NATS server port.

Lattice ID to connect to.

Control interface host.

new: Create project from template (component, provider).
build: Build and sign component or provider.
dev: Start hot-reload development loop.
up: Bootstrap local wasmCloud environment.
down: Tear down local environment.
app: Manage declarative applications (wadm).
start: Start a component or provider.
stop: Stop a running component or provider.
scale: Scale component instances.
push: Push artifact to OCI registry.
pull: Pull artifact from OCI registry.
inspect: Show component WIT interfaces and metadata.
lint: Check component for common issues.
completions: Generate shell completions.

Requires language-specific toolchains (Rust, Go, TinyGo) for building components. Local development needs Docker or Podman for NATS messaging. Some features require wasmCloud host running.

wash was created by the wasmCloud project as the primary interface for WebAssembly component development. The wasmCloud platform emerged from the Wasm community's effort to build distributed systems using the Component Model. wash consolidated multiple tools into a single CLI, becoming the standard interface for the wasmCloud ecosystem.

wasm-tools(1), wasmtime(1), docker(1)