Skip to content

Configure CI, shells, and the Go API ​

Keep automation isolated from your normal Wago install, remove prompts from scripts, add shell completions, and set runtime policy from Go.

Isolate Wago state ​

Set WAGO_HOME to place manager configuration, installed runtimes, and caches under one root:

sh
WAGO_HOME="$PWD/.wago-ci" wago version current

Give concurrent CI jobs separate directories. Inspect paths rather than guessing:

sh
wago status --json
wago version which
wago cache dir

Automation flags ​

FlagMeaning
--no-inputNever prompt; fail if input is missing
--dry-runShow a supported mutation plan
--jsonEmit machine-readable output where supported
--lockedRefuse manifest or lockfile changes
--offlineUse installed and cached resources only

For a prepared repeatable build:

sh
wago run --locked --offline --invoke fib fib.wasm 20

Describe the command surface programmatically:

sh
wago commands --json

Shell completions ​

sh
wago config completions zsh
wago config completions zsh --install

Use --output for a specific completion file and --rc for a particular startup file. Preview installation with --dry-run.

Go API ​

Use RuntimeConfig for compiler policy and WithPolicy for per-instance guest limits. The runnable configuration example is in Create runtimes and modules.

Released under the Apache 2.0 License.