clang-include-cleaner

A Python distribution of clang-include-cleaner - the LLVM-based tool that finds unused #include directives in C++ source files. Install it with a single pip install, no LLVM toolchain required.

---

Table of Contents

• Installation
• Related Projects
• Contributing
• License

Installation

pip install clang-include-cleaner

The wheel bundles a statically-linked binary and clang builtin headers - no LLVM installation is required on the host machine.

Tip

In CI, use pipx run clang-include-cleaner — no install needed. All GitHub Actions runners ship with pipx pre-installed.

Verify:

clang-include-cleaner --version

Run clang-include-cleaner --help to see all available options.

For full usage documentation, see the upstream docs.

Related Projects

• clang-format-wheel — pip-installable clang-format binary
• clang-tidy-wheel — pip-installable clang-tidy binary
• clang-apply-replacements-wheel — pip-installable clang-apply-replacements binary

Contributing

We welcome contributions! See CONTRIBUTING.md for development setup, build instructions, and the release process.

Please use GitHub issues for bug reports and feature requests.

License

This project is licensed under the Apache License 2.0 with LLVM exceptions - see LICENSE.md for details.

The clang-include-cleaner binary bundled in the wheels is part of the LLVM Project and is provided under the same license.