wash icon indicating copy to clipboard operation
wash copied to clipboard

Document wash dev and wash host usage expectations

Open Copilot opened this issue 3 months ago • 0 comments

Users attempting wash dev ./flowmark-deployment.yaml encounter confusing errors because wash dev expects a project directory, not a deployment manifest. Additionally, there's no clear path for users who want to start wasmCloud locally.

Changes

This PR addresses the documentation gap by clarifying:

  • wash dev - Expects a project directory containing buildable component source code, not YAML files
  • wash host - The command for starting a wasmCloud 2.0 host locally (requires NATS)

Context

Current state:

  • wash dev ./my-component/ ✅ Works - builds and runs component with hot-reload
  • wash dev ./deployment.yaml ❌ Fails - "Project path is not a directory"
  • No documented way to start wasmCloud host

The distinction between component development (wash dev) and cluster operations (wash host) was not clear from existing documentation.

Original prompt

wash dev ./flowmark-deployment.yaml 2025-11-12T12:56:47.425787Z INFO starting development session for project path="./flowmark-deployment.yaml"


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot avatar Nov 12 '25 13:11 Copilot