id       = "wasmer"
name     = "Wasmer"
homepage = "https://wasmer.io/"
executables   = ["wasmer"]

[dotfiles]

# Wasmer's own integration-test repository identifies ~/.wasmer/wasmer.toml as
# the CLI registry config. It contains the registry token; retain the config
# root for non-cache settings while classifying that file as a credential.
# https://github.com/wasmerio/wasmer-integration-tests (WASMER_TOKEN notes)
paths = ["~/.wasmer/"]
exclude = [
  "~/.wasmer/cache/",
]
secret = ["~/.wasmer/wasmer.toml"]

[commands]
format = 1
label = "Wasmer"
description = "Run WebAssembly modules and packages."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["run"]
label = "Run a Wasm module or package"
description = "Run a .wasm/.wat file, URL or registry package. Environment variables, networking, journals and compiler backend options are left out."

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/wasmerio/wasmer/blob/main/lib/cli/src/commands/run/mod.rs"
revision = "main 2026-10-27"
evidence = """--stack-size  Set the default stack size (default is 1048576)
--entrypoint  The entrypoint module for webc packages.
--invoke  The function to invoke.
<INPUT>  The file, URL, or package to run.
[ARGS]...  Command-line arguments passed to the package
--volume [HOST_DIR:]GUEST_DIR  Map a host directory to a different location for the Wasm module
--cwd  Set the module's initial CWD to this path
--forward-host-env  Forward all host env variables to guest
--offline  Resolve only from local sources, never the registry
--no-tty  Disables the TTY bridge"""

[[commands.subcommand.field]]
id = "input"
label = "File, URL or package"
type = "string"
position = 0
min = 1
sources = ["src"]

[[commands.subcommand.field]]
id = "volume"
label = "Mount directory"
description = "Map a host directory into the module as [HOST_DIR:]GUEST_DIR."
type = "string"
option = ["--volume"]
multiple = true
sources = ["src"]

[[commands.subcommand.field]]
id = "cwd"
label = "Initial working directory"
type = "string"
option = ["--cwd"]
sources = ["src"]

[[commands.subcommand.field]]
id = "invoke"
label = "Function to invoke"
type = "string"
option = ["--invoke"]
sources = ["src"]

[[commands.subcommand.field]]
id = "entrypoint"
label = "Entrypoint (webc packages)"
type = "string"
option = ["--entrypoint"]
sources = ["src"]

[[commands.subcommand.field]]
id = "forward_host_env"
label = "Forward host environment"
type = "boolean"
option = ["--forward-host-env"]
sources = ["src"]

[[commands.subcommand.field]]
id = "offline"
label = "Offline (local sources only)"
type = "boolean"
option = ["--offline"]
sources = ["src"]

[[commands.subcommand.field]]
id = "no_tty"
label = "Disable TTY bridge"
type = "boolean"
option = ["--no-tty"]
sources = ["src"]

[[commands.subcommand.field]]
id = "stack_size"
label = "Stack size (bytes)"
type = "integer"
option = ["--stack-size"]
sources = ["src"]

[[commands.subcommand.field]]
id = "args"
label = "Program arguments"
description = "Passed to the program after the module."
type = "string"
position = 1
multiple = true
sources = ["src"]

[[commands.subcommand.task]]
id = "run"
label = "Run a module"
fields = ["input", "args"]
required = ["input"]

[[commands.subcommand.task]]
id = "run_mounted"
label = "Run with a mounted directory"
fields = ["input", "volume", "args"]
required = ["input", "volume"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["input", "args", "volume", "invoke"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["cwd", "entrypoint", "forward_host_env", "offline", "no_tty", "stack_size"]