moon-component - SKILL.md Agent Skill

name: moon-component description: How to use the moon-component CLI (MoonBit WIT/component workflow).

moon-component Skill

Use this skill when you need to use the moon-component CLI to build or compose WebAssembly Components from WIT + MoonBit.

Common Commands (CLI)

# Generate MoonBit bindings from WIT
moon-component generate wit/world.wit -o .

# Build core wasm (MoonBit)
moon build --target wasm --release impl

# Componentize core wasm
moon-component componentize _build/wasm/release/build/impl/impl.wasm \
  --wit-dir wit -o impl.component.wasm

# Full workflow (generate + build + componentize)
moon-component component wit/world.wit -o impl.component.wasm --release

Compose Components

# Use a config file (default entry)
moon-component compose -c moon-component.toml

Guest / Host

Guest: WIT 実装側。generate で impl/ を生成して実装し、componentize する。
Host: component を呼ぶ側。必要なら wac plug で合成してから実行。

Examples

examples/regex (Rust guest + MoonBit host)
examples/hello (最小の export)
examples/host/* (他言語 host)

Gotchas

cabi unused warnings are expected in generated code
world and interface must not share the same name in WIT