CLI Commands

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

init (alias: i)

Initializes a new Hybroid Live project in the current directory.

hybroid init --package my-project --name "My Level" --output out

Flag	Required	Description
--package	Yes	Kebab-case package name
--name	Yes	Display name of the level
--output	Yes	Output directory for compiled Lua files

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

build (alias: b)

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

hybroid build

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

watch (alias: w)

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

hybroid watch

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

add (alias: a)

Caution

The add command is a stub. Package management from the PewPew Marketplace is not yet implemented.

language-server (aliases: server, lsp)

Starts the Hybroid Language Server Protocol (LSP) process for editor integration.

hybroid language-server

This is used by editors (such as VS Code) to provide autocompletion, diagnostics, and other IDE features. It reads from standard input and writes to standard output following the LSP specification. This command is typically invoked automatically by the editor extension rather than directly by users.