Weft CLI reference
Generated from the CLI definition by weft docs – do not edit by hand.
weft
Author once, compile to every coding-agent harness. (weft v1.5.1)
USAGE `weft init|validate|build|install|uninstall|update|import|marketplace|eval|publish|sign|verify|index|docs`
COMMANDS
`init` Scaffold a new plugin (weft.yaml + a sample skill)
`validate` Statically validate a plugin (the valid badge)
`build` Compile a plugin (or a marketplace of plugins) to harness manifests
`install` Compile + place a plugin (or a whole marketplace) into harness scopes
`uninstall` Remove what install placed into this project (read from its weft.lock)
`update` Re-resolve refs, recompile, and re-place only artifacts whose hash changed
`import` Reverse-compile an existing native plugin/marketplace into a Weft plugin
`marketplace` Drive each harness's native marketplace CLI (register/install everywhere)
`eval` Run a component's evals against the real harnesses (reports UNTESTED honestly)
`publish` Run the deterministic publish gate (static valid + trace/output evals)
`sign` Sign weft.lock's artifact set (ed25519) -> weft.sig + weft.pub (the signed badge)
`verify` Verify weft.sig against weft.lock and the on-disk artifacts
`index` Build a metadata index from plugin dirs (optionally federating the MCP Registry)
`docs` Print the full CLI reference (a CLI map), generated from the command tree
Use `weft <command> --help` for more information about a command.
weft build
Compile a plugin (or a marketplace of plugins) to harness manifests
Compile a plugin (or a marketplace of plugins) to harness manifests (weft build v1.5.1)
USAGE `weft build [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Local dir, or a remote ref (github:/npm:/owner/repo, optional //subdir)
OPTIONS
`--out=".weft-out"` Output directory
`--target` Comma-separated targets (default: all registered)
`--bare` Write straight to --out without the <target>/ subdir, so a repo root becomes a native marketplace. Accepts multiple --target (unioned into one tree); errors if two targets write different content to the same path.
`--check` Verify --out is already up to date with a fresh compile instead of writing (exit 1 on drift); the CI guard for a committed `--out . --bare` marketplace. Does not detect orphaned files.
`--harness` Declare installed harness version(s) to check the emitted format against, e.g. `codex@0.130` (comma-separated). Skips auto-detection for those targets.
`--no-harness-check` Detect the installed harness version per target and warn when the emitted format is outside the adapter's verified range (axis 4). Use --no-harness-check for hermetic builds.
weft docs
Print the full CLI reference (a CLI map), generated from the command tree
Print the full CLI reference (a CLI map), generated from the command tree (weft docs v1.5.1)
USAGE `weft docs [OPTIONS] `
OPTIONS
`--out` Write the Markdown reference to this file instead of stdout
weft eval
Run a component’s evals against the real harnesses (reports UNTESTED honestly)
Run a component's evals against the real harnesses (reports UNTESTED honestly) (weft eval v1.5.1)
USAGE `weft eval [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Plugin directory
OPTIONS
`--component` Only eval this component leaf name
`--harness` Restrict to these harnesses (comma-separated)
`--compare` Vibes A/B: run each case against this git ref (or dir) and the working tree, side by side
weft import
Reverse-compile an existing native plugin/marketplace into a Weft plugin
Reverse-compile an existing native plugin/marketplace into a Weft plugin (weft import v1.5.1)
USAGE `weft import [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Dir with an existing native plugin or marketplace
OPTIONS
`--from="claude"` Source harness format
`--out="imported"` Output directory
`--namespace` Reverse-DNS namespace to assign (default com.imported)
weft index
Build a metadata index from plugin dirs (optionally federating the MCP Registry)
Build a metadata index from plugin dirs (optionally federating the MCP Registry) (weft index v1.5.1)
USAGE `weft index [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Plugin directories
OPTIONS
`--out="index.json"` Output index file
`--federate` Ingest the MCP Registry (GET /v0.1/servers)
weft init
Scaffold a new plugin (weft.yaml + a sample skill)
Scaffold a new plugin (weft.yaml + a sample skill) (weft init v1.5.1)
USAGE `weft init [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Target directory
OPTIONS
`--name` Plugin name (kebab-case)
`--namespace` Reverse-DNS namespace, e.g. com.acme
weft install
Compile + place a plugin (or a whole marketplace) into harness scopes
Compile + place a plugin (or a whole marketplace) into harness scopes (weft install v1.5.1)
USAGE `weft install [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Local dir, or a remote ref (github:/npm:/owner/repo, optional //subdir)
OPTIONS
`--scope="project"` user | project
`--target` Comma-separated targets (default: all registered)
`--only` Comma-separated component names to install piecemeal (e.g. one skill)
`--all` Install to requested targets even if the harness is not detected
`--managed` Managed mode: only allow these namespaces (comma-separated allowlist)
`--cwd` Project root for project-scope placement (default: cwd)
weft marketplace
Drive each harness’s native marketplace CLI (register/install everywhere)
Drive each harness's native marketplace CLI (register/install everywhere) (weft marketplace v1.5.1)
USAGE `weft marketplace add|remove|install`
COMMANDS
`add` Register a marketplace with every installed harness
`remove` Remove a registered marketplace from every harness
`install` Install a plugin from a registered marketplace on every harness
Use `weft marketplace <command> --help` for more information about a command.
weft publish
Run the deterministic publish gate (static valid + trace/output evals)
Run the deterministic publish gate (static valid + trace/output evals) (weft publish v1.5.1)
USAGE `weft publish [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Plugin directory
OPTIONS
`--snapshot` Snapshot eval scores into evals/.baselines/ for the next release
weft sign
Sign weft.lock’s artifact set (ed25519) -> weft.sig + weft.pub (the signed badge)
Sign weft.lock's artifact set (ed25519) -> weft.sig + weft.pub (the signed badge) (weft sign v1.5.1)
USAGE `weft sign [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Plugin dir with weft.lock
weft uninstall
Remove what install placed into this project (read from its weft.lock)
Remove what install placed into this project (read from its weft.lock) (weft uninstall v1.5.1)
USAGE `weft uninstall [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Install target holding weft.lock (default: derived from --scope)
OPTIONS
`--scope="project"` user | project
`--plugin` Remove only this plugin (id or bare name); default removes all
weft update
Re-resolve refs, recompile, and re-place only artifacts whose hash changed
Re-resolve refs, recompile, and re-place only artifacts whose hash changed (weft update v1.5.1)
USAGE `weft update [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Plugin directory
OPTIONS
`--scope="project"` user | project
`--target` Comma-separated targets (default: all registered)
`--cwd` Project root for project-scope placement (default: cwd)
weft validate
Statically validate a plugin (the valid badge)
Statically validate a plugin (the valid badge) (weft validate v1.5.1)
USAGE `weft validate [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Plugin directory
weft verify
Verify weft.sig against weft.lock and the on-disk artifacts
Verify weft.sig against weft.lock and the on-disk artifacts (weft verify v1.5.1)
USAGE `weft verify [OPTIONS] [DIR]`
ARGUMENTS
`DIR="."` Plugin dir with weft.lock