Skip to content

CLI Commands

Hybroid Live provides a command-line interface for project management and compilation.

Initializes a new Hybroid Live project in the current directory.

Terminal window
hybroid init --package my-project --name "My Level" --output out
FlagRequiredDescription
--packageYesKebab-case package name
--nameYesDisplay name of the level
--outputYesOutput directory for compiled Lua files

This creates a hybconfig.toml file and a level.hyb template.

Transpiles all .hyb files in the project to Lua. Reads hybconfig.toml from the current directory.

Terminal window
hybroid build

Output is written to the configured output directory. A manifest.json is also generated for PewPew Live compatibility.

Watches the project directory for changes and automatically rebuilds when a .hyb file is modified.

Terminal window
hybroid watch

Runs indefinitely. Only triggers on .hyb file writes (ignores .lua files).