Skip to content

Make targets

Every make target you run day to day, generated from the ## comments in the Makefile. Add a ## description to a target there and it appears here. make help prints a shorter version in the terminal.

target what it does
make all Default target; same as build.
make configure Run CMake configure only, no compile (build/).
make build Configure and compile the CLI, library, and tests (build/).
make build-cuda Configure and compile with the CUDA backend (build-cuda/).
make test-cuda Build the CUDA variant and run ctest against it.
make build-asan Build the ASan + UBSan variant (build-asan/).
make test-asan Build the ASan + UBSan variant and run ctest (CI-only on macOS).
make clean Remove build/, build-cuda/, and build-asan/.
make rebuild Clean, then build.
make format clang-format in place over src/, include/, tests/, benchmarks/.
make format-check Check formatting with clang-format --dry-run --Werror (CI gate).
make lint-python Run ruff over python/ and scripts/ (pinned via uvx).
make lint Run clang-tidy over src/, header-filtered to bonsai.
make run Build, then run ./build/src/bonsai with ARGS.
make params-json Re-extract docs/use/parameters.src.json from the built CLI and rerender the page.
make test Build, fetch the pinned test datasets, run ctest.
make python Build the _bonsai Python extension into build/python/.
make python-test Build the extension and run the Python test suites.
make python-cuda Build the CUDA-enabled Python extension into build-cuda/python/.
make fit-benchmark Compare bonsai against reference libraries on California housing.
make bench-scaling Run the synthetic rows/cols/bins/threads scaling sweep.
make bench-iso Run the iso-volume bonsai arms on this host's GPU.
make help List the common make targets.
make docs-check Verify generated docs and lint prose (the five CI doc gates).
make install-hooks Point core.hooksPath at the versioned hooks (commit-msg format gate).
make skills Install project-local Claude Code skills (currently caveman).
make skills-clean Remove installed project-local skills.