Home cli-tool

Gxwf

Galaxy workflow design-time CLI (validate, convert, lint, roundtrip, tool-cache discovery).

Revised
2026-06-18
Rev
2

gxwf

Foundry’s primary design-time CLI for Galaxy workflow validation and conversion. Bundled with @galaxy-tool-util/cli alongside galaxy-tool-cache; subcommand pages cover individual operations.

Install

npx --yes --package @galaxy-tool-util/cli@1.8.1 gxwf <subcommand> runs without a global install. For repeat use, npm install -g @galaxy-tool-util/cli@1.8.1.

The pin is load-bearing: the draft-tier subcommands (draft-validate, draft-next-step, draft-extract) the per-step authoring loop depends on first shipped in 1.7.2, and the floor tracks 1.8.1 to stay in lockstep with galaxy-tool-cache (same npm package) where stock/built-in tool resolution lands. Pinning the npx --package spec forces resolution past any stale install. Tracks the ^1.8.1 devDependency in the repo package.json / pnpm-lock.yaml.

availability_check is a capability probe, not a version check: gxwf --version reports a hardcoded 1.0.0 regardless of the published package version, so a version-number gate would reject the correct CLI. gxwf --help | grep -q draft-validate instead asserts the actual draft-tier capability the pin exists for — it passes on a CLI that has the subcommands and fails on a genuinely older one, independent of the bogus version string.