Skip to content

mise tool-stub ​

Run a tool stub file

A tool stub is an executable file whose shebang is #!/usr/bin/env -S mise tool-stub and whose body is TOML naming a tool, version, and executable. Running the stub runs this command, which installs the tool if needed and runs it with the stub's arguments. You rarely call it directly; create stubs with mise generate tool-stub.

#!/usr/bin/env -S mise tool-stub
# Node.js 24

tool = "node"
version = "24"
bin = "node"

See https://mise.jdx.dev/dev-tools/tool-stubs.html

Arguments ​

  • <FILE> — Path to the TOML tool stub file to execute

    Every field is optional: version defaults to latest, tool defaults to the stub's file name (or http:<file name> when the stub sets url or platform URLs), and bin defaults to the stub's file name. A stub can also set backend-specific options.

  • [ARGS]… — Arguments to pass to the tool

    Every argument after the stub path is passed to the tool unchanged, including a literal --.

MIT LicenseCopyright © 2026jdx.dev