Appendix B: CLI Command Reference
This document provides a reference for all the commands available in the worka command-line interface.
worka init
Scaffolds a new Worka pack in the specified directory, creating a starter template with all the necessary files.
Usage:
worka init [path] [options]
| Argument / Option | Description |
|---|---|
path | The directory to initialize the pack in. Defaults to the current directory (.). |
--tenant | The tenant name for the pack (e.g., your GitHub username). If omitted, the CLI will prompt for it. |
--name | The machine-readable name for the pack (e.g., my-cool-pack). If omitted, the CLI will prompt for it. |
--display-name | The human-readable name for the pack. If omitted, the CLI will prompt for it. |
--template | The template to use (e.g., hello-world). |
worka build
Builds your pack into a WASM artifact suitable for installation and distribution. This command compiles the pack, validates the manifest, and emits the final WASM.
Usage:
worka build [options]
| Option | Description |
|---|---|
--path <PATH> | The path to the pack you want to build. Defaults to the current directory (.). |
--release | Build with release optimizations. |
worka doctor
Runs environment checks and reports missing tools or configuration. Use this when setting up a new machine.
Usage:
worka doctor [options]
| Option | Description |
|---|---|
--fix | Attempt to auto‑fix common issues (where safe). |