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. |