Skip to main content

ember CLI

The ember command comes from openember-cli. It orchestrates Kconfig and CMake only; each target project must ship CMakeLists.txt and scripts/kconfig/menuconfig.sh / genconfig.sh at the expected paths.

From the project root

/path/to/<project>/scripts/ember build

Both OpenEmber and EmberLite ship a compatible scripts/ember.

Environment variables

VariableMeaning
OPENEMBER_ROOTForce project root (highest priority)
OPENEMBER_BUILD_DIRDefault build directory name (build)
OPENEMBER_JOBSParallel build jobs
OPENEMBER_KCONFIG_NONINTERACTIVE=1Non-interactive default .config
OPENEMBER_KCONFIG_FRONTENDS_DIROverride kconfig-frontends location

Environment registry (ember add / use / list)

ember add emberlite /path/to/emberlite
ember add openember /path/to/openember
ember use emberlite
ember list

Data defaults to ~/.openember/ember/.

Commands (summary)

CommandRole
menuconfig [build_dir]Interactive Kconfig; writes .config and runs genconfig
genconfig [build_dir].configconfig.cmake
update / configurecmake -S . -B <build_dir>
build [build_dir]Full pipeline when needed
allmenuconfig + update + build
clean [build_dir]Remove build tree
completion bashPrint Bash completion
install / uninstallSymlink ember into PATH (~/.local/bin by default)

Full manual: openember-cli README.