CLI Reference

The Rux compiler is the source of truth for this reference. The checked-in contract was generated by rux 0.4.0 using help schema version 1.

Command syntax

rux [global-options] <command> [command-options] [operands]

Global options may appear before or after the command. Value options accept separated and equals forms. Only rux run treats tokens after -- as child-program arguments.

Commands

CommandPurpose
rux addAdd a dependency to the manifest
rux buildBuild the current package
rux checkCheck package source code for errors without building
rux cleanRemove build artifacts
rux docGenerate package documentation
rux fmtFormat source files and manifests
rux helpShow help information
rux infoShow package metadata and manifest information
rux initInitialize a Rux package in the current directory
rux installInstall dependencies
rux lintLint package source files
rux listList dependencies
rux loginStore a registry token for publishing
rux logoutRemove a stored registry token
rux newCreate a new Rux package
rux packBuild the publishable package archive
rux publishPublish the package to the registry
rux removeRemove a dependency from the manifest
rux runBuild and run the main executable
rux testRun all test targets
rux uninstallUninstall dependencies
rux updateUpdate dependencies
rux versionShow version information

Streams and exit status

Primary output and JSON use stdout. Progress, warnings, and errors use stderr. Success, help, and version exit 0; invalid CLI usage exits 2; compiler or operational failures exit 1. rux run returns the child program's exit code after a successful build.

Structured help

rux help --json returns the full stable contract. rux help <command> --json returns one command. Both use schemaVersion: 1 and omit build timestamps.

Start here