WASM-TOOLS(WIT-SMITH)

💅 WASM-TOOLS(WIT-SMITH) 💅

okay bestie sit DOWN because we're reading the manual page for wasm-tools wit-smith together and honestly?? it's giving generator 👑

🎀 NAME 🎀

wasm-tools wit-smith — a WIT test case generator. that's the whole job description, no notes 💖

---

✨ SYNOPSIS ✨

wasm-tools wit-smith [OPTIONS] [INPUT]

---

🦋 DESCRIPTION 🦋

so like. it's a WIT test case generator 💫

give it some arbitrary input seed and boom — wit-smith generates a valid WIT package set encoded as a WebAssembly component. the way it works is that the input seed gets interpreted as a series of predetermined choices walking through a decision tree 🌳 so it's fully deterministic: same input seed in, same output WebAssembly component out, every single time, no cap 🫶

this tool is perfect for taking fuzz-generated input and turning it into a wide array of WIT documents. iconic behaviour honestly 🔥

🌈 Example 🌈

generate a WIT document from 100 bytes of random data, watch her go:

$ head -c 100 /dev/urandom | wasm-tools wit-smith -t

Arguments:

• [INPUT] — the arbitrary input seed 🌱 if you don't supply this argument, then stdin is used instead. she'll just sip from the stream, no problem 💧

---

⭐ OPTIONS ⭐

• -o, --output <OUTPUT> — where to place output 📁 if you don't provide this, then stdout is used.
• -t, --wat — output the text format of WebAssembly instead of the binary format 👀 (text format girlies rise)
• --max-packages <MAX_PACKAGES> — [default: 10]
• --max-type-size <MAX_TYPE_SIZE> — [default: 100]
• --max-interface-items <MAX_INTERFACE_ITEMS> — [default: 10]
• --max-world-items <MAX_WORLD_ITEMS> — [default: 10]
• --max-pkg-items <MAX_PKG_ITEMS> — [default: 10]
• --max-type-parts <MAX_TYPE_PARTS> — [default: 10]
• --max-files-per-package <MAX_FILES_PER_PACKAGE> — [default: 10]
• --max-resource-items <MAX_RESOURCE_ITEMS> — [default: 10]
• --arbitrary-config — indicates that "arbitrary configuration" should be used 🎛️ meaning that the input seed is first used to generate the configuration, and then afterwards the rest of the seed is used to generate the document. two-for-one seed usage, we love efficiency ✨
• -v, --verbose... — use verbose output (-v info, -vv debug, -vvv trace) 🗣️ the more v's the more she talks
• --color <COLOR> — configuration over whether terminal colors are used in output 🎨 supports one of auto|never|always|always-ansi. the default is to detect what to do based on the terminal environment, for example by using isatty. [default: auto]
• -h, --help — print help (see a summary with '-h') 🙋

---

💀 quick vibe check reminder: that determinism thing is a promise, not a suggestion — same seed, same output, always. don't come for her consistency.

and that's the page, bestie 🧚 this was wasm-tools wit-smith version 1.239.0+ds, page 1, dated August 2026 — mwah, go generate something cute 💜🌸