oroc

oroc is the Oro Runtime command line tool. It builds, runs, packages, and inspects Oro Runtime projects.

Usage#

oroc [SUBCOMMAND] [options] [<project-dir>]
oroc [SUBCOMMAND] -h

Subcommands#

• help — Search help and command pages
• build — Build
• run — Run
• init — Create a project
• setup — Install toolchain dependencies
• install-app — Install to a device/target
• list-devices — List connected devices
• print-build-dir — Print build output path
• config — Inspect config values
• env — Print relevant environment variables
• mcp — Run an MCP server
• version — Inspect or bump project version
• versions — Print CLI/runtime dependency versions
• update — Update tooling

Global options#

Option	Description
-h, --help	print help
--prefix	print install path
-v, --version	print program version
-q, --quiet	hint for less log output
-V, --verbose	verbose output (can be global)
-D, --debug	debug output (can be global)
--no-color	disable colored log output
--json	structured JSON logs on stdout
--log-file=<path>	mirror logs to a JSON file

Logging and debug environment#

Variable	Meaning
ORO_DEBUG	enable debug mode (like -D)
ORO_VERBOSE	enable verbose logs (like -V)
ORO_LOG_NO_COLOR	disable colored log output
ORO_LOG_JSON	enable structured JSON logs on stdout
ORO_LOG_FILE	mirror logs to a JSON file
ORO_ALLOW_EXEC	allow external exec during builds
ORO_ENABLE_SANITIZERS	enable ASan/UBSan on desktop builds

Config discovery (project vs source)#

Most commands accept a project directory. build and run can also take a single HTML file or JavaScript module. When no oro.toml is found, oroc infers a minimal configuration automatically.

See: Config overview.