CLI Reference

Complete documentation for the Nimbus command-line interface. Run, debug, and build your applications.

Overview

The nimbus executable is your entry point for all operations. It must be in your system PATH.

Usage

nimbus <command> [options]

Command	Description
`run`	Execute an application normally.
`dev`	Run with DevTools and Hot Reload enabled.
`build`	Compile the application to a standalone EXE.
`new`	Create a new project from a template.
`--version`	Display the installed version.
`--help`	Show help information.

Starts the application in production mode. No debug logs or hot reload.

nimbus run App.xml

If you don't specify a file, it looks for nimbus.json or App.xml in the current folder.

Starts the application in development mode. This enables:

nimbus dev App.xml [options]

Flag	Description
`-p, --port <number>`	Set DevTools HTTP port (default: 9222).
`--no-debug`	Disable interactive console (useful for scripts).

nimbus dev App.xml --port 8080

Compiles your project into a single, dependency-free executable.

nimbus build App.xml [options]

Flag	Description
`-o, --output <dir>`	Output directory (default: ./build).
`-n, --name <name>`	Name of the executable (e.g., MyApp).
`-i, --icon <path>`	Application icon (.ico file).
`--console`	Keep console window visible (for debugging).
`--compress`	Optimize binary size (removes debug symbols).

nimbus build App.xml -o ./dist -n Calculator --icon icon.ico

Creates a new project folder with starter files.

nimbus new <ProjectName> [template]

Name	Description
`default`	Basic Hello World app (default).
`calculator`	A fully functional calculator.
`todo`	Todo list application.

# Create basic app
nimbus new MyAwesomeApp

# Create calculator
nimbus new MyCalc calculator