clang-tools static binaries

Includes clang-format, clang-tidy, clang-query, clang-apply-replacements, clang-include-cleaner (LLVM 18+), llvm-cov, llvm-profdata, llvm-symbolizer and clang-scan-deps — all the tools you need for C/C++ formatting, static analysis, coverage, symbolization and dependency scanning.

Table of Contents

• Installation
• Clang/LLVM Tools Version Support Matrix
• Download
• How can I trust this repository?
• Motivation
• Building locally

Installation

Install clang-tools via your preferred package manager, take clang-format as an example:

# pip (all platforms)
pip install clang-tools
clang-tools install clang-format

# asdf (all platforms)
asdf plugin add clang-format https://github.com/cpp-linter/asdf-clang-tools.git
asdf install clang-format latest

# Homebrew (macOS only)
brew tap cpp-linter/tap
brew install clang-format

Or download pre-built binaries directly from the Releases page.

Clang/LLVM Tools Version Support Matrix

Tools	OS/Version	22	21	20	19	18	17	16	15	14	13	12
clang-format	All platforms1	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
clang-tidy	All platforms	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
clang-query	All platforms	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
clang-apply-replacements	All platforms	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
clang-include-cleaner	All platforms	✔️	✔️	✔️	✔️	✔️	❌	❌	❌	❌	❌	❌
llvm-cov ✨	All platforms	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
llvm-profdata ✨	All platforms	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
llvm-symbolizer ✨	All platforms	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
clang-scan-deps ✨	All platforms	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️

Note

Version Support Policy

Each release includes a rolling window of the latest LLVM major versions. Older versions are retired on a regular cadence to keep build times manageable and maintenance sustainable.

Current policy: The N latest major LLVM versions are supported, where N is determined by the project maintainers (typically 7–8 major versions). When a new LLVM version is added, the oldest one is retired in the same release.

Retired versions:

Version	Released	Retired
v7	May 2019	Feb 2025
v8	Jul 2019	Sep 2025
v9	Sep 2019	Mar 2026
v10	Mar 2020	Mar 2026
v11	Oct 2020	Jun 2026

Binaries for retired versions remain available in historical releases on the Releases page. Each release ships an immutable versions.json that documents exactly which LLVM versions are included — downstream tools (pip, asdf, Homebrew) should use this file to discover available versions rather than hardcoding a list.

If you need a retired version, you can still download it from an older release, or build it locally using python build.py --version <N>.

Retiring a version is a build-time and storage decision, not a statement about the quality of that LLVM release. Old binaries remain on GitHub Releases indefinitely.

Download

• Download clang-tools static binaries for your platform from the Releases tab.
• Alternatively, use pip, asdf, or Homebrew (macOS) to download and manage them.
• For programmatic access, the latest release includes a versions.json file that maps each LLVM version to its source release, lists all shipped tools (with minimum-version constraints), and enumerates supported platforms. This is the single source of truth for all downstream channels (pip, asdf, homebrew, scoop, etc.) — do not maintain separate tool/version lists elsewhere.

How can I trust this repository?

• Releases are immutable — once published, assets and metadata (versions.json) are never modified.

• Verify checksums using the SHA512SUMS file included in every release:

  # Download a binary and its SHA512SUMS file for your platform/version
  # Then verify:
  sha512sum -c SHA512SUMS --ignore-missing

  Each SHA512SUMS file contains SHA-512 hashes for all binaries in that platform+version group, in the standard POSIX format used by Linux distributions.

• Fork this repository and run GitHub actions on your behalf

• Build and test manually using python build.py (see above) or the steps in .github/workflows

Motivation behind this repo

Different projects often use different versions of clang-format and clang-tidy. Installing multiple versions via system package managers can quickly get out of hand, and compiling each one from source is time-consuming.

This repository solves that by providing pre-built static binaries for many LLVM versions across multiple platforms.

These binaries aim to:

• be as small as possible
• not require any additional dependencies apart from the OS itself

This repository (cpp-linter/clang-tools-static-binaries) is forked from muttleyxd/clang-tools-static-binaries.

Building locally

A Python build script is provided so you can reproduce any build on your own machine without needing GitHub Actions. See CONTRIBUTING.md for detailed contribution guidelines.

Prerequisites (install once per platform):

Platform	Requirements
Linux x86-64	gcc-10, cmake, make
Linux ARM64	gcc-10, cmake, make
macOS x86-64	Homebrew, gcc@14, cmake
macOS ARM64	Homebrew, gcc@14, cmake
Windows x86-64	Visual Studio with C++ tools, cmake
Windows ARM64	Visual Studio with C++ tools, cmake

Run the script:

# build clang-tools version 18 for the auto-detected host OS
python build.py --version 18

# explicitly target a platform
python build.py --version 17 --platform macos-arm64

# write downloads and build artifacts to a custom directory
python build.py --version 20 --platform linux-amd64 --build-dir /tmp/llvm-build

Run python build.py --help for the full list of options.

The script performs exactly the same steps as the CI workflow: downloads the LLVM source, applies any necessary patches, configures and builds with CMake, smoke-tests each binary, and writes the renamed binaries and a SHA512SUMS checksum file into <release>/build/bin/.

Footnotes

1. All platforms: Linux x86-64, Linux ARM64, macOS x86_64, macOS ARM64, Windows x86-64, Windows ARM64 ↩