Luau Run - Luau and Roblox test runner

Started: 2026-07-25 | Last major update: 2026-10-15 | Last updated: 2026-10-25

Runs Luau tests from the command line

Currently only supports Lute, and Roblox Studio, locally.

Status

area	state
Jest specs on Lute	supported
script tests on Lute	supported
Jest specs in Roblox Studio	supported, with Studio hidden and nothing installed into it
running offline	yes, once luau-run setup has run
updating itself	luau-run update, for the one-liner install
Windows, x64	supported
macOS and Linux	planned

Tested on Windows 10 (build 19044) with Lute 1.0.1-nightly.20260729.

Requires Windows 10 version 1809 or later on an x64 processor. luau-run setup downloads Lute. Tests on Lute also need the Microsoft Visual C++ Redistributable, and tests in Roblox Studio need Studio and Rojo.

Install (one-liner)

Windows:

irm https://github.com/PRMS-magnet/luau-run/releases/latest/download/install.ps1 | iex

Install covers other ways to install, updating and uninstalling.

Quick start

luau-run init --default-runtime lute --test-root tests --example-spec   # luau-run.toml and an example spec
luau-run test                                                           # PASS  2 tests

luau-run init       # in a project you already have: reads it and suggests a setup
luau-run doctor     # where each tool and setting came from
luau-run --help     # every command and option

Documentation

• Getting started
• Install
• Writing tests and running them
• Configuration
• Tests in Roblox Studio
• Refusals
• Building from source

Credits

Jest specs run on Jest-Portable, PRMS’s fork of Roblox’s Jest Roblox. Tests run on Lute, and Studio places are built with Rojo.

Roadmap

Luau Run is beta software and does not have everything planned for it yet. ROADMAP.md lists what is still to come.

License

MIT

AI Policy