Install CradleXC
CradleXC provides the cxc command-line interface used to validate, compile and process CRADLE scenarios.
This guide covers installing CradleXC, verifying the installation and checking the dependencies available on your system.
Install from the CRADLE APT repository
CradleXC is distributed as a prebuilt binary through the CRADLE APT repository.
Add the repository to your system:
echo "deb [trusted=yes] https://repo.cradle-lang.org/apt/ /" \
| sudo tee /etc/apt/sources.list.d/cradle.list
Update the local package index:
sudo apt update
Install CradleXC:
sudo apt install cxc
You can browse the packages published in the CRADLE repository.
Verify the installation
Confirm that the cxc executable is available:
cxc --version
If the command succeeds, CradleXC is installed and available on your system PATH.
You can also confirm its location with:
which cxc
Check dependencies
Run the built-in dependency check:
cxc doctor
cxc doctor checks the dependencies required by CradleXC and any backend plugins
currently available to it.
If dependencies are missing, display the installation guidance with:
cxc install-deps
Resolve any required dependency issues reported by cxc doctor before using the
affected functionality.
View the current configuration
To inspect the configuration currently used by CradleXC, run:
cxc config
This is useful when checking local paths, repository configuration or other settings used by the CLI.
Update CradleXC
CradleXC is updated through APT.
Refresh the package index:
sudo apt update
Upgrade CradleXC:
sudo apt install --only-upgrade cxc
Confirm the installed version:
cxc --version
Troubleshooting
cxc: command not found
Confirm that CradleXC is installed:
which cxc
If no path is returned, verify the installation and ensure the location containing the
cxc binary is included in your system PATH.
Missing dependencies
Run:
cxc doctor
Then view the corresponding installation guide:
cxc install-deps
Next steps
- Follow the Quick Start for the basic CRADLE workflow.
- Build your first CRADLE scenario.
- Learn how to validate and compile a scenario.
- Learn how to inspect compiler output.
- Learn how to use a backend plugin to generate target-specific files.
- See Troubleshooting if you encounter installation or configuration issues.