Skip to content

Installation

You can install Lutest with a toolchain manager.

Add Lutest to your local mise.toml:

[tools]
"github:lutest-dev/lutest" = "latest"

Then install the tool:

Terminal window
mise install

After that, you can run:

Terminal window
lutest help

If you use Rokit, add Lutest with:

Terminal window
rokit add lutest-dev/lutest

Then verify the install:

Terminal window
lutest help

Lutest is currently distributed through GitHub Releases.

If you want a reproducible setup, pin a specific version in your toolchain config instead of using the latest release.

Today, if you want to use Lutest inside a lute project, the practical path is Loom.

This part is not optional.

Installing the Lutest CLI through a toolchain manager gives you the command-line tool, but your project still needs the Lutest package dependency.

That package is what the CLI uses to identify test modules during discovery.

pesde and wally are not a good fit for Lutest in its current shape, so this project uses lute’s own package flow instead.

Create a loom.config.luau in your project root:

return {
package = {
name = "my-project",
version = "0.4.0",
dependencies = {
lutest = {
name = "lutest",
rev = "v0.4.0",
sourceKind = "github",
source = "https://github.com/lutest-dev/lutest",
},
},
},
}

Then install it with:

Terminal window
lute pkg install

That creates loom.lock.luau and installs the dependency into Packages/.

Without that package dependency in the project, Lutest has no configured test library path to look for, so your test modules will not be discovered the intended way.

When you want to move to a newer release later, update rev to the new tag and run lute pkg install again.