whamm

whamm — WebAssembly Instrumentation Tool

Entry point for installing, configuring, and running whamm! (v0.1.0). whamm! instruments compiled .wasm binaries using a DTrace-inspired .mm monitor script; no source changes to the target application are required.

For the .mm language itself — probe syntax, events, libraries, and examples — load the companion whamm-dsl skill in this plugin.

Install (mise github backend)

Copy the stanzas from templates/mise.toml into your project's mise.toml. Full explanation of asset patterns, Rosetta caveat, and build-from-source steps lives in references/installation.md.

[tools."github:ejrgilbert/whamm"]
version = "0.1.0"

[tools."github:ejrgilbert/whamm".platforms]
linux-x64   = { asset_pattern = "whamm-linux-x86_64" }
macos-x64   = { asset_pattern = "whamm-macos-x86_64" }
macos-arm64 = { asset_pattern = "whamm-macos-x86_64" }  # Rosetta 2

Verify the install:

mise install
whamm --help

v0.1.0 ships bare binaries for x86_64 only. On Apple Silicon without Rosetta 2, build from source — see references/installation.md.

CLI quickstart

Full flag reference lives in references/cli.md. Core commands:

# Instrument: bytecode-rewriting path
whamm instr --app app.wasm --script monitor.mm -o out.wasm

# Compile monitor for engine-support (wei) path — no --app
whamm instr --script monitor.mm --wei -o monitor.wasm

# Inspect bound variables available at a match rule
whamm info --rule "wasm:opcode:call:before"

# Global help
whamm --help

Set RUST_LOG={error|warn|info|debug|trace|off} to control verbosity.

End-to-end workflow (bytecode-rewriting path)

1. Write a .mm monitor script (see whamm-dsl skill).
2. Instrument the target module:

   whamm instr --app app.wasm --script monitor.mm -o out.wasm
   

3. Run the instrumented module. The rewriting path requires whamm_core.wasm preloaded at runtime:

   wasmtime run \
     --env TO_CONSOLE=true \
     --preload whamm_core=whamm_core.wasm \
     out.wasm