cpp-linter Homebrew Tap

Homebrew tap for clang-tools-static-binaries.

Provides pre-built static binaries for:

• clang-format
• clang-tidy
• clang-query
• clang-apply-replacements
• clang-include-cleaner (LLVM 18+)

No compilation required — binaries are downloaded directly from GitHub Releases.

Installation

# Add the tap
brew tap cpp-linter/tap

Install all tools (bundle)

# Install the latest version (currently LLVM 22)
brew install clang-tools

# Install a specific version
brew install clang-tools@21
brew install clang-tools@20
brew install clang-tools@19
brew install clang-tools@18

Install individual tools

Install only what you need:

# Latest versions
brew install clang-format      # only clang-format
brew install clang-tidy        # only clang-tidy
brew install clang-query       # only clang-query
brew install clang-apply-replacements  # only clang-apply-replacements
brew install clang-include-cleaner     # only clang-include-cleaner

# Specific older versions
brew install clang-format@18
brew install clang-tidy@19
brew install clang-query@20
# ... etc.

Usage

After installation, tools are available on your PATH:

clang-format --version
clang-tidy --version
clang-query --version
clang-apply-replacements --version
clang-include-cleaner --version   # LLVM 18+

How It Works

Each formula downloads the pre-built static binaries from the cpp-linter/clang-tools-static-binaries GitHub Releases matching your macOS architecture (ARM64 or x86_64).

The SHA-256 checksums are verified during installation.

Bundle vs. individual formulas

Formula	Installs
clang-tools / clang-tools@<ver>	All 5 tools
clang-format / clang-format@<ver>	Only clang-format
clang-tidy / clang-tidy@<ver>	Only clang-tidy
clang-query / clang-query@<ver>	Only clang-query
clang-apply-replacements / clang-apply-replacements@<ver>	Only clang-apply-replacements
clang-include-cleaner / clang-include-cleaner@<ver>	Only clang-include-cleaner

Updating

brew update
brew upgrade clang-tools

To update a single tool:

brew upgrade clang-format

Development

To update the formulae after a new release:

bash scripts/update-formula.sh <release-tag>

Example:

bash scripts/update-formula.sh 2026.06.15-a56c0263

This will regenerate all Formula/*.rb files (both bundle and individual tool formulae) with the correct URLs and SHA-256 checksums.

There is also a GitHub Actions workflow (.github/workflows/update-formula.yml) that runs automatically when a new release is published in the upstream repo.